Extract a value from a dictionary by matching the placeholder selector against its keys.
The Dictionary source resolves a selector against an IDictionary, a generic IDictionary<string, object>, or a dynamic ExpandoObject. It returns the value whose key matches the selector. When the dictionary key is not a string, the source converts it with ToString before comparing.
The key comparison uses the case sensitivity setting of the formatter.
You can nest dictionaries and drill into them with dot notation, for example {Numbers.One}.
Put the nullable operator before a key, as in {City?.Name}, to get an empty result, not an error, when City is null or has no Name key. A missing City key is still an error.
| Smart String | Arguments | Result |
|---|---|---|
{SomeKey} |
{ ["SomeKey"] = 999 } |
999 |
Hello {Name} {Surname} |
{ ["Name"] = "Gordon", ["Surname"] = "Freeman" } |
Hello Gordon Freeman |
{Numbers.One} {Letters.A} |
nested dictionaries | 1 a |
var args = new Dictionary<string, object>
{
["Name"] = "Gordon",
["Surname"] = "Freeman",
};
// "Hello Gordon Freeman"
Smart.Format("Hello {Name} {Surname}", args);