Funzione StrComp (Visual Basic)
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 |
---|---|---|
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)
Requisiti
Spazio dei nomi:Microsoft.VisualBasic
**Modulo:**Strings
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)
Vedere anche
Riferimenti
Riepilogo della gestione delle stringhe