141

This is what I know

str = String.Format("Her name is {0} and she's {1} years old", "Lisa", "10");

But I want something like

str = String("Her name is @name and she's @age years old");
str.addParameter(@name, "Lisa");
str.addParameter(@age, 10);
11
  • 4
    Why you require such format? whats wrong with .Format Commented Apr 21, 2016 at 4:33
  • 4
    @un-lucky I'm formatting a very long string and when I have to edit it it's very hard Commented Apr 21, 2016 at 4:38
  • 9
    You can use var name = "Lisa"; var age = 10; var str = $"Her name is {name} and she's {age} years old;" in C#6 Commented Apr 21, 2016 at 4:38
  • 3
    @ZoharPeled readability is one advantage, if you have many parameters it becomes hard to track what goes where. Commented Apr 21, 2016 at 4:54
  • 3
    This becomes an important issue when you translate the string into a different language! Then the order of the placeholders might be reversed. If you want to internationalize your application, such a string formatting scheme gives the translator more freedom. Commented Apr 21, 2016 at 15:01

9 Answers 9

182

In C# 6 you can use string interpolation:

string name = "Lisa";
int age = 20;
string str = $"Her name is {name} and she's {age} years old";

As Doug Clutter mentioned in his comment, string interpolation also supports format string. It's possible to change the format by specifying it after a colon. The following example will output a number with a comma and 2 decimal places:

var str = $"Your account balance is {balance:N2}"

As Bas mentioned in his answer, string interpolation doesn't support template string. Actually, it has no built in support for that. Fortunately it exists in some great libraries.


SmartFormat.NET for example has support for named placeholders:

Smart.Format("{Name} from {Address.City}, {Address.State}", user)

// The user object should at least be like that 

public class User
{
    public string Name { get; set; }
    public Address Address { get; set; }
}

public class Address
{
    public string City { get; set; }
    public string State { get; set; }
}

It is available on NuGet and has excellent documentation.


Mustache is also a great solution. Bas has described its pros well in his answer.

Sign up to request clarification or add additional context in comments.

2 Comments

so no way to make format string as a variable in the interpolation? aka double d = 6.0; string format = "F2"; string interpolation = $"{d:format}";
This answer is not about string formatting but string interpolation which is something different. The OP asked about string formatting. Think of a resource string with (preferably named) placeholders that goes into String.Format (or just using the $ sign) and then replace the placeholders with const or var values.
60

If you don't have C#6 available in your project you can use Linq's .Aggregate():

    var str = "Her name is @name and she's @age years old";

    var parameters = new Dictionary<string, object>();
    parameters.Add("@name", "Lisa");
    parameters.Add("@age", 10);

    str = parameters.Aggregate(str, (current, parameter)=> current.Replace(parameter.Key, parameter.Value.ToString()));

If you want something matching the specific syntax in the question you can put together a pretty simple class based on Aggregate:

public class StringFormatter{

    public string Str {get;set;}

    public Dictionary<string, object> Parameters {get;set;}

    public StringFormatter(string p_str){
        Str = p_str;
        Parameters = new Dictionary<string, object>();
    }

    public void Add(string key, object val){
        Parameters.Add(key, val);
    }

    public override string ToString(){
        return Parameters.Aggregate(Str, (current, parameter)=> current.Replace(parameter.Key, parameter.Value.ToString()));
    }

}

Usable like:

var str = new StringFormatter("Her name is @name and she's @age years old");
str.Add("@name", "Lisa");
str.Add("@age", 10);

Console.WriteLine(str);

Note that this is clean-looking code that's geared to being easy-to-understand over performance.

1 Comment

Note that with this solution, if @name contains @age, it will be replaced again, which is likely undesired.
35

If you are ok assigning a local variable that contains the data you use to replace the template parameters, you can use the C# 6.0 string interpolation feature.

The basic principle is that you can do fairly advanced string replacement logic based on input data.

Simple example:

string name = "John";
string message = $"Hello, my name is {name}."

Complex example:

List<string> strings = ...
string summary = $"There are {strings.Count} strings. " 
  + $"The average length is {strings.Select(s => s.Length).Average()}"

Drawbacks:

  • No support for dynamic templates (e.g. from a resources file)

(Major) advantages:

  • It enforces compile time checks on your template replacement.

A nice open source solution that has almost the same syntax, is Mustache. It has two available C# implementations from what I could find - mustache-sharp and Nustache.

I have worked with mustache-sharp and found that it does not have the same power as the string interpolation, but comes close. E.g. you can do the following (stolen from it's github page).

Hello, {{Customer.Name}}
{{#newline}}
{{#newline}}
{{#with Order}}
{{#if LineItems}}
Here is a summary of your previous order:
{{#newline}}
{{#newline}}
{{#each LineItems}}
    {{ProductName}}: {{UnitPrice:C}} x {{Quantity}}
    {{#newline}}
{{/each}}
{{#newline}}
Your total was {{Total:C}}.
{{#else}}
You do not have any recent purchases.
{{/if}}
{{/with}}

3 Comments

No support for dynamic templates? Do you mean that we cannot load a string "This is {name} and he is {age} years old" let's say from a config file and then do the interpolation somewhere in the code, whereby the variables 'name' and 'age' might be available but "unseen" because interpolation works only at compile time? Why not give some interpolation method the string and pass by the needed variables like this: string s = "This is {name} and he is {age} years old"; // loaded from file name = "Tini"; age = 21; string s2 = s.Interpolate(name,age); Is there such method available?
That would be nice. I'd like to know too. Sounds like it's only possible with a third-party library. In my situation I'd like to have the template be a constant - what you have as "string s".
As today, mustache refer to Stubble as the official C# implementation.
19

With C# 6 you can use String Interpolation to directly add variables into a string.

For example:

string name = "List";
int age = 10;

var str = $"Her name is {name} and she's {age} years old";

Note, the use of the dollar sign ($) before the string format.

3 Comments

I think the String.Format call is useless here since you are using string interpolation.
@Fabien you're correct, edited. And seems like you got in just ahead of me.
This is not an answer to the question. The question is about to supply values for placeholders {} in a string.
18

So why not just Replace?

string str = "Her name is @name and she's @age years old";
str = str.Replace("@name", "Lisa");
str = str.Replace("@age", "10");

2 Comments

this will generate as many additional strings as you have variables, which may not be desired
Why not? Perhaps many reasons. It takes three lines instead of one. If @name contains @age it will be interpolated, but not vice versa. It is inefficient, scanning the string once for every variable. @ can't be escaped with, say, \@ or @@.
8

There is no built in way to do this, but you can write a class that will do it for you.
Something like this can get you started:

public class ParameterizedString
{
    private string _BaseString;
    private Dictionary<string, string> _Parameters;

    public ParameterizedString(string baseString)
    {
        _BaseString = baseString;
        _Parameters = new Dictionary<string, string>();
    }

    public bool AddParameter(string name, string value)
    {
        if(_Parameters.ContainsKey(name))
        {
            return false;
        }
        _Parameters.Add(name, value);
        return true;
    }

    public override string ToString()
    {
        var sb = new StringBuilder(_BaseString);
        foreach (var key in _Parameters.Keys)
        {
            sb.Replace(key, _Parameters[key]);
        }
        return sb.ToString();
    }
}

Note that this example does not force any parameter name convention. This means that you should be very careful picking your parameters names otherwise you might end up replacing parts of the string you didn't intend to.

Comments

6

string interpolation is a good solution however it requires C#6.

In such case I am using StringBuilder

var sb = new StringBuilder();

sb.AppendFormat("Her name is {0} ", "Lisa");
sb.AppendFormat("and she's {0} years old", "10");
// You can add more lines

string result = sb.ToString();

Comments

2

You can also use expressions with C#6's string interpolation:

string name = "Lisa";
int age = 20;
string str = $"Her name is {name} and she's {age} year{(age == 1 ? "" : "s")} old";

Comments

1
    string name = "Lisa";
    int age = 20;
    string str = $"Her name is {name} and she's {age} years old";

This is called an Interpolated String, which is a basically a template string that contains expressions inside of it.

Comments

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.