Istruzione Option Compare

Articolo
04/05/2024

Dichiara il metodo di confronto predefinito da usare durante il confronto dei dati di tipo stringa.

Sintassi

Option Compare { Binary | Text }

Parti

Termine Definizione

Binary Facoltativo. Consente di eseguire confronti tra stringhe basati su un criterio di ordinamento derivato dalle rappresentazioni binarie interne dei caratteri.

Questo tipo di confronto è particolarmente utile se le stringhe possono contenere caratteri che non devono essere interpretati come testo. In questo caso, non è consigliabile consentire che il confronto sia falsato da equivalenze alfabetiche, ad esempio dalla mancata distinzione tra maiuscole e minuscole.

Text Facoltativo. Consente di eseguire confronti tra stringhe basati su un criterio di ordinamento testuale senza distinzione tra maiuscole e minuscole determinato dalle impostazioni locali del sistema.

Questo tipo di confronto è utile se le stringhe contengono tutti caratteri di testo e si vuole confrontarle prendendo in considerazione le equivalenze alfabetiche, quali la mancata distinzione tra maiuscole e minuscole e le lettere strettamente correlate. Ad esempio, è possibile considerare le lettere A e a equivalenti e fare in modo che le lettere Ä e ä precedano B e b.

Termine	Definizione
`Binary`	Facoltativo. Consente di eseguire confronti tra stringhe basati su un criterio di ordinamento derivato dalle rappresentazioni binarie interne dei caratteri. Questo tipo di confronto è particolarmente utile se le stringhe possono contenere caratteri che non devono essere interpretati come testo. In questo caso, non è consigliabile consentire che il confronto sia falsato da equivalenze alfabetiche, ad esempio dalla mancata distinzione tra maiuscole e minuscole.
`Text`	Facoltativo. Consente di eseguire confronti tra stringhe basati su un criterio di ordinamento testuale senza distinzione tra maiuscole e minuscole determinato dalle impostazioni locali del sistema. Questo tipo di confronto è utile se le stringhe contengono tutti caratteri di testo e si vuole confrontarle prendendo in considerazione le equivalenze alfabetiche, quali la mancata distinzione tra maiuscole e minuscole e le lettere strettamente correlate. Ad esempio, è possibile considerare le lettere `A` e `a` equivalenti e fare in modo che le lettere `Ä` e `ä` precedano `B` e `b`.

Osservazioni:

Se usato, è necessario includere l'istruzione Option Compare in un file prima di tutte le altre istruzioni del codice sorgente.

L'istruzione Option Compare specifica il metodo di confronto tra stringhe (Binary o Text). Il metodo di confronto del testo predefinito è Binary.

Un confronto Binary confronta il valore numerico Unicode di ogni carattere in ciascuna stringa. Un confronto Text confronta ogni carattere Unicode in base al relativo significato lessicale nelle impostazioni cultura correnti.

Il criterio di ordinamento di Microsoft Windows è determinato dalla tabella codici. Per altre informazioni, vedere Tabelle codici.

Nell'esempio seguente i caratteri nella tabella codici (ANSI 1252) per le lingue inglese ed europee vengono ordinati usando Option Compare Binary, che determina un tipico ordinamento binario.

A < B < E < Z < a < b < e < z < À < Ê < Ø < à < ê < ø

Se gli stessi caratteri nella stessa tabella codici venissero ordinati con Option Compare Text, si otterrebbe il seguente ordinamento testuale.

(A=a) < (À = à) < (B=b) < (E=e) < (Ê = ê) < (Z=z) < (Ø = ø)

Quando non è presente un'istruzione Option Compare

Se il codice sorgente non contiene un'istruzione Option Compare, viene utilizzata l'impostazione Option Compare nella pagina Compilazione, Creazione progetti (Visual Basic). Se si usa il compilatore a riga di comando, viene usata l'impostazione specificata dall'opzione del compilatore -optioncompare.

Nota

I nomi o i percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi. Per altre informazioni, vedere Personalizzazione dell'IDE.

Per impostare Option Compare nell'IDE

Selezionare un progetto in Esplora soluzioni. Scegliere Proprietà dal menu Progetto.
Fare clic sulla scheda Compila.
Impostare il valore della casella Option Compare.

Quando si crea un progetto, l'impostazione Option Compare nella scheda Compila viene impostata con il valore dell'impostazione Option Compare della finestra di dialogo Opzioni. Per modificare questa impostazione, scegliere Opzioni dal menu Strumenti. Nella finestra di dialogo Opzioni espandere Progetti e soluzioni, quindi fare clic su Impostazioni predefinite di Visual Basic. L'impostazione predefinita iniziale in Impostazioni predefinite di Visual Basic è Binario.

Per impostare Option Compare sulla riga di comando

Includere l'opzione del compilatore -optioncompare nel comando vbc.

Esempio 1

Nell'esempio seguente viene usata l'istruzione Option Compare per impostare il confronto binario come metodo predefinito per il confronto tra stringhe. Per usare questo codice, rimuovere il commento dall'istruzione Option Compare Binary e inserirlo all'inizio del file di origine.

' Option Compare Binary

Console.WriteLine("A" < "a")
' Output: True

Esempio 2

Nell'esempio seguente viene usata l'istruzione Option Compare per impostare il criterio di ordinamento del testo senza distinzione tra maiuscole e minuscole come metodo predefinito per il confronto tra stringhe. Per usare questo codice, rimuovere il commento dall'istruzione Option Compare Text e inserirlo all'inizio del file di origine.

' Option Compare Text

Console.WriteLine("A" = "a")
' Output: True