Ungültige Formatzeichenfolge (IDE0043)

Property Wert
Regel-ID IDE0043
Title Ungültige Formatzeichenfolge
Kategorie Style
Unterkategorie Sprachregeln (Zeichenfolgenvorgänge)
Anwendbare Sprachen C# und Visual Basic
Options Nichts

Übersicht

Mit dieser Regel werden Aufrufe zusammengesetzter Formatierungsmethoden gekennzeichnet, z String.Format. B. wenn ein Platzhalterindex in der Formatzeichenfolge auf ein Argument verweist, das nicht vorhanden ist. Wenn die Formatzeichenfolge beispielsweise {1} enthält, aber nur ein Argument bereitgestellt wird (verfügbar als {0}), kennzeichnet die Regel den Platzhalter {1}.

Hinweis

Diese Regel ähnelt der Codequalitätsregel CA2241, die auch formatbasierte Zeichenfolgenargumente überprüft.

Example

// Code with violations.
// '{1}' is out of range — only one argument is provided.
string s = string.Format("Hello, {0}! You have {1} messages.", "Alice");

// Fixed code.
string s = string.Format("Hello, {0}! You have {1} messages.", "Alice", 5);
' Code with violations.
' '{1}' is out of range — only one argument is provided.
Dim s As String = String.Format("Hello, {0}! You have {1} messages.", "Alice")

' Fixed code.
Dim s As String = String.Format("Hello, {0}! You have {1} messages.", "Alice", 5)

Unterdrücken einer Warnung

Wenn Sie nur einen einzelnen Verstoß unterdrücken möchten, fügen Sie Ihrer Quelldatei Präprozessordirektiven hinzu, um die Regel zu deaktivieren und dann erneut zu aktivieren.

#pragma warning disable IDE0043
// The code that's violating the rule is on this line.
#pragma warning restore IDE0043

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad auf none in der Konfigurationsdatei fest.

[*.{cs,vb}]
dotnet_diagnostic.IDE0043.severity = none

Um alle Codestilregeln zu deaktivieren, legen Sie den Schweregrad für die Kategorie Style auf none in der Konfigurationsdatei fest.

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Siehe auch