String.Format
is a wonderful method, a real life saver when it comes to producing (readable) formatted text from within code. I use it everywhere, but it gets a bit tedious typing the same boilerplate code to use it properly:
string formatted = string.Format(CultureInfo.InvariantCulture,
"Formatted text {0:-15} example generated on {1:d}", meaningfulString, DateTime.Now);
That “string.Format(CultureInfo.InvariantCulture,
” over 40 characters before you get the meat of the statement. Sure you can drop the invariant culture bit but then you can introduce weird formatting problems on different machines…. no, what I need is a useful extension method to take my pain away:
public static string ToFormattedString(this string template, params object[] args)
{
return template.ToFormattedString(CultureInfo.InvariantCulture, args);
}
public static string ToFormattedString(this string template,
IFormatProvider formatter, params object[] args)
{
if (string.IsNullOrEmpty(template)) return string.Empty;
return string.Format(formatter, template, args);
}
Now the above example becomes:
string formatted = "Formatted text {0:-15}
example generated on {1:d}".ToFormattedString(meaningfulString, DateTime.Now);
It’s definitely an improvement and the important bit of the statement (the template with formatting) is right at the front for easy debugging.
Excellent, How Do I Retrofit This Into My Existing Code?
Good question, glad you asked. I simply used Visual Studio's Find and Replace using regular expressions:
The find regex (using VS’s “special” regex format) is:
string.Format\(CultureInfo.InvariantCulture,:b*{:q|:i}:b@,:b@
The replace regex is:
\1.ToFormattedString(
Obviously, you'll also need a ‘using
’ statement at the top of your class file with the namespace of the static
class containing the extension methods.