Simplify interpolation (IDE0071)
Property | Value |
---|---|
Rule ID | IDE0071 |
Title | Simplify interpolation |
Category | Style |
Subcategory | Language rules (expression-level preferences) |
Applicable languages | C# and Visual Basic |
Options | dotnet_style_prefer_simplified_interpolation |
Overview
This style rule concerns with simplification of interpolated strings to improve code readability. It recommends removal of certain explicit method calls, such as ToString()
, when the same method would be implicitly invoked by the compiler if the explicit method call is removed.
Options
Options specify the behavior that you want the rule to enforce. For information about configuring options, see Option format.
dotnet_style_prefer_simplified_interpolation
Property | Value | Description |
---|---|---|
Option name | dotnet_style_prefer_simplified_interpolation | |
Option values | true |
Prefer simplified interpolated strings |
false |
Do not prefer simplified interpolated strings | |
Default option value | true |
// dotnet_style_prefer_simplified_interpolation = true
var str = $"prefix {someValue} suffix";
// dotnet_style_prefer_simplified_interpolation = false
var str = $"prefix {someValue.ToString()} suffix";
' dotnet_style_prefer_simplified_interpolation = true
Dim str = $"prefix {someValue} suffix"
' dotnet_style_prefer_simplified_interpolation = false
Dim str = $"prefix {someValue.ToString()} suffix"
Suppress a warning
If you want to suppress only a single violation, add preprocessor directives to your source file to disable and then re-enable the rule.
#pragma warning disable IDE0071
// The code that's violating the rule is on this line.
#pragma warning restore IDE0071
To disable the rule for a file, folder, or project, set its severity to none
in the configuration file.
[*.{cs,vb}]
dotnet_diagnostic.IDE0071.severity = none
To disable all of the code-style rules, set the severity for the category Style
to none
in the configuration file.
[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none
For more information, see How to suppress code analysis warnings.