StrComp-Funktion (Visual Basic)

Artikel
08/20/2008

Aktualisiert: November 2007

Gibt abhängig vom Ergebnis eines Zeichenfolgenvergleichs den Wert -1, 0 oder 1 zurück.

Public Shared Function StrComp( _
   ByVal String1 As String, _
   ByVal String2 As String, _
   <Microsoft.VisualBasic.OptionCompareAttribute> _
   Optional ByVal Compare As Microsoft.VisualBasic.CompareMethod _
) As Integer

Parameter

String1
Erforderlich. Ein beliebiger gültiger String-Ausdruck.
String2
Erforderlich. Ein beliebiger gültiger String-Ausdruck.
Compare
Optional. Gibt den Typ des Zeichenfolgenvergleichs an. Wenn kein Wert für Compare angegeben wird, wird der Vergleichstyp durch die Option Compare-Einstellung festgelegt.

Einstellungen

Die Einstellungen für das Compare-Argument sind:

Konstante	Beschreibung
Binary	Führt einen binären Vergleich basierend auf einer Sortierreihenfolge durch, die von den internen binären Darstellungen der Zeichen abgeleitet wird.
Text	Führt einen Textvergleich basierend auf einer Textsortierreihenfolge durch, die vom aktuellen Kulturwert der Anwendung vorgegeben wird. Die Groß-/Kleinschreibung wird dabei nicht berücksichtigt.

Rückgabewert

Die StrComp-Funktion besitzt die folgenden Rückgabewerte.

Wenn	Rückgabewert von StrComp
String1 Sortierung vor String2	-1
String1 = String2	0
String1 Sortierung nach String2	1

Ausnahmen

Ausnahmetyp	Fehlernummer	Bedingung
ArgumentException	5	Der Compare-Wert ist ungültig.

Beachten Sie die Spalte "Fehlernummer", wenn Sie Visual Basic 6.0-Anwendungen aktualisieren, die eine unstrukturierte Fehlerbehandlung verwenden. (Sie können die Fehlernummer mit der Number-Eigenschaft (Err-Objekt) vergleichen.) Wenn möglich, sollten Sie jedoch erwägen, eine solche Fehlersteuerung durch eine Übersicht über die strukturierte Ausnahmebehandlung für Visual Basic zu ersetzen.

Hinweise

Die Zeichenfolgen werden ab dem ersten Zeichen nach alphanumerischen Sortierwerten verglichen. Weitere Informationen über binäre Vergleiche und Textvergleiche sowie Sortierreihenfolgen finden Sie unter Option Compare-Anweisung.

Sicherheitshinweis:
Wenn die Anwendung Sicherheitsentscheidungen aufgrund der Ergebnisse einer Vergleichsoperation oder einer Operation zum Ändern der Groß-/Kleinschreibung durchführt, sollte die Operation die String.Compare-Methode verwenden und als comparisonType-Argument Ordinal oder OrdinalIgnoreCase übergeben. Weitere Informationen finden Sie unter Auswirkungen der Kultur auf Zeichenfolgen in Visual Basic.

Beispiel

In diesem Beispiel wird die StrComp-Funktion verwendet, um das Ergebnis eines Zeichenfolgenvergleichs zurückzugeben. Wird das dritte Argument ausgelassen, wird der Vergleichstyp ausgeführt, der in der Option Compare-Anweisung oder in den Projektstandardwerten definiert ist.

' Defines variables.
Dim TestStr1 As String = "ABCD"
Dim TestStr2 As String = "abcd"
Dim TestComp As Integer
' The two strings sort equally. Returns 0.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Text)
' TestStr1 sorts after TestStr2. Returns -1.
TestComp = StrComp(TestStr1, TestStr2, CompareMethod.Binary)
' TestStr2 sorts before TestStr1. Returns 1.
TestComp = StrComp(TestStr2, TestStr1)