CA1858: Verwenden von ‚StartsWith‘ anstelle von ‚IndexOf‘

Eigenschaft	Wert
Regel-ID	CA1858
Titel	StartsWith statt IndexOf verwenden
Kategorie	Leistung
Fix führt oder führt nicht zur Unterbrechung	Nicht unterbrechend
Standardmäßig in .NET 8 aktiviert	Als Vorschlag

Ursache

String.IndexOf wird aufgerufen, und das Ergebnis wird mit Null verglichen.

Regelbeschreibung

Es ist effizienter und transparenter, String.StartsWith aufzurufen, als String.IndexOf aufzurufen und das Ergebnis mit Null zu vergleichen, um zu bestimmen, ob eine Zeichenfolge mit einem bestimmten Präfix beginnt.

IndexOf durchsucht die gesamte Zeichenfolge, während StartsWith nur den Anfang der Zeichenfolge vergleicht.

Behandeln von Verstößen

Ersetzen Sie den Aufruf von String.IndexOf durch einen Aufruf von String.StartsWith.

Beispiel

Der folgende Codeausschnitt zeigt eine Verletzung von CA1858:

bool M(string s)
{
    return s.IndexOf("abc") == 0;
}

Function M(s As String) As Boolean
    Return s.IndexOf("abc") = 0
End Function

Der folgende Codeausschnitt korrigiert die Verletzung:

bool M(string s)
{
    return s.StartsWith("abc");
}

Function M(s As String) As Boolean
    Return s.StartsWith("abc")
End Function

Wann sollten Warnungen unterdrückt werden?

Es ist ungefährlich, diese Warnung zu unterdrücken, wenn die Leistung kein Problem ist.

Unterdrücken einer Warnung

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.

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

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

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

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