Funzione StrComp (Visual Basic)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituisce -1, 0 o 1 in base al risultato di un confronto tra stringhe.

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

Parametri

String1
Obbligatorio. Qualsiasi espressione String valida.
String2
Obbligatorio. Qualsiasi espressione String valida.
Compare
Facoltativo. Specifica il tipo di confronto tra stringhe. Se Compare viene omesso, il tipo di confronto sarà determinato dall'impostazione di Option Compare.

Impostazioni

Le possibili impostazioni dell'argomento Compare sono:

Costante	Descrizione
Binary	Consente di eseguire un confronto binario basato su un criterio di ordinamento derivato dalle rappresentazioni binarie interne dei caratteri.
Text	Consente di eseguire un confronto di testi seguendo un criterio di ordinamento testuale in cui non viene fatta distinzione tra maiuscole e minuscole, in base alle informazioni sulle impostazioni cultura correnti dell'applicazione.

Valore restituito

La funzione StrComp restituisce i seguenti valori:

Se	StrComp restituirà
String1 si trova nell'ordine prima di String2	-1
String1 è uguale a String2	0
String1 si trova nell'ordine dopo String2	1

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	Il valore di Compare non è valido.

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Il confronto tra le stringhe avviene a partire dal primo carattere ordinando i valori di ogni carattere secondo un criterio alfanumerico. Per ulteriori informazioni sui confronti binari e testuali e sul criterio di ordinamento, vedere Istruzione Option Compare.

Nota sulla sicurezza:
Se l'applicazione prende decisioni di protezione in base al risultato di un confronto o un'operazione basata sul risultato di una modifica, l'operazione dovrebbe utilizzare il metodo String.Compare e passare Ordinal o OrdinalIgnoreCase per l'argomento comparisonType. Per ulteriori informazioni, vedere Influenza delle impostazioni cultura sulle stringhe in Visual Basic.

Esempio

Nell'esempio riportato di seguito la funzione StrComp viene utilizzata per restituire il risultato di un confronto tra stringhe. Se il terzo argomento viene omesso, verrà eseguito il tipo di confronto definito nell'istruzione Option Compare o nelle impostazioni predefinite del progetto.

' 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)