Istruzione Option CompareOption Compare Statement

Dichiara il metodo di confronto predefinito da usare durante il confronto dei dati di tipo stringa.Declares the default comparison method to use when comparing string data.

SintassiSyntax

Option Compare { Binary | Text }  

PartiParts

TermineTerm DefinizioneDefinition
Binary Facoltativo.Optional. Consente di eseguire confronti tra stringhe basati su un criterio di ordinamento derivato dalle rappresentazioni binarie interne dei caratteri.Results in string comparisons based on a sort order derived from the internal binary representations of the characters.

Questo tipo di confronto è particolarmente utile se le stringhe possono contenere caratteri che non devono essere interpretati come testo.This type of comparison is useful especially if the strings can contain characters that are not to be interpreted as text. In questo caso, non è consigliabile consentire che il confronto sia falsato da equivalenze alfabetiche, ad esempio dalla mancata distinzione tra maiuscole e minuscole.In this case, you do not want to bias comparisons with alphabetical equivalences, such as case insensitivity.
Text Facoltativo.Optional. 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.Results in string comparisons based on a case-insensitive text sort order determined by your system's locale.

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.This type of comparison is useful if your strings contain all text characters, and you want to compare them taking into account alphabetic equivalences such as case insensitivity and closely related letters. Ad esempio, è possibile considerare le lettere A e a equivalenti e fare in modo che le lettere Ä e ä precedano B e b.For example, you might want to consider A and a to be equal, and Ä and ä to come before B and b.

NoteRemarks

Se usato, è necessario includere l'istruzione Option Compare in un file prima di tutte le altre istruzioni del codice sorgente.If used, the Option Compare statement must appear in a file before any other source code statements.

L'istruzione Option Compare specifica il metodo di confronto tra stringhe (Binary o Text).The Option Compare statement specifies the string comparison method (Binary or Text). Il metodo di confronto del testo predefinito è Binary.The default text comparison method is Binary.

Un confronto Binary confronta il valore numerico Unicode di ogni carattere in ciascuna stringa.A Binary comparison compares the numeric Unicode value of each character in each string. Un confronto Text confronta ogni carattere Unicode in base al relativo significato lessicale nelle impostazioni cultura correnti.A Text comparison compares each Unicode character based on its lexical meaning in the current culture.

Il criterio di ordinamento di Microsoft Windows è determinato dalla tabella codici.In Microsoft Windows, sort order is determined by the code page. Per altre informazioni, vedere Tabelle codici.For more information, see Code Pages.

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.In the following example, characters in the English/European code page (ANSI 1252) are sorted by using Option Compare Binary, which produces a typical binary sort order.

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.When the same characters in the same code page are sorted by using Option Compare Text, the following text sort order is produced.

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

Quando non è presente un'istruzione Option CompareWhen an Option Compare Statement Is Not Present

Se il codice sorgente non contiene un Option Compare istruzione, il Option Compare impostazione il pagina compilazione, creazione progetti (Visual Basic) viene usato.If the source code does not contain an Option Compare statement, the Option Compare setting on the Compile Page, Project Designer (Visual Basic) is used. Se si usa il compilatore della riga di comando, l'impostazione specificata per il /optioncompare viene utilizzata l'opzione del compilatore.If you use the command-line compiler, the setting specified by the /optioncompare compiler option is used.

Nota

Nomi o percorsi visualizzati per alcuni elementi dell'interfaccia utente di Visual Studio nelle istruzioni seguenti potrebbero essere diversi nel computer in uso.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. La versione di Visual Studio in uso e le impostazioni configurate determinano questi elementi.The Visual Studio edition that you have and the settings that you use determine these elements. Per altre informazioni, vedere Personalizzazione dell'IDE.For more information, see Personalizing the IDE.

Per impostare Option Compare nell'IDETo set Option Compare in the IDE

  1. Selezionare un progetto in Esplora soluzioni.In Solution Explorer, select a project. Scegliere Proprietà dal menu Progetto.On the Project menu, click Properties.

  2. Fare clic sulla scheda Compila.Click the Compile tab.

  3. Impostare il valore di Option Compare casella.Set the value in the Option Compare box.

Quando si crea un progetto, il Option Compare impostazione nel compilare scheda è impostata sul Option Compare impostazione nel opzioni finestra di dialogo.When you create a project, the Option Compare setting on the Compile tab is set to the Option Compare setting in the Options dialog box. Per modificare questa impostazione, scegliere il degli strumenti menu, fare clic su opzioni.To change this setting, on the Tools menu, click Options. Nella finestra di dialogo Opzioni espandere Progetti e soluzioni, quindi fare clic su Impostazioni predefinite di Visual Basic.In the Options dialog box, expand Projects and Solutions, and then click VB Defaults. L'impostazione predefinita iniziale in le impostazioni predefinite di Visual Basic viene binario.The initial default setting in VB Defaults is Binary.

Per impostare Option Compare sulla riga di comandoTo set Option Compare on the command line

EsempioExample

Nell'esempio seguente viene usata l'istruzione Option Compare per impostare il confronto binario come metodo predefinito per il confronto tra stringhe.The following example uses the Option Compare statement to set the binary comparison as the default string comparison method. Per usare questo codice, rimuovere il commento dall'istruzione Option Compare Binary e inserirlo all'inizio del file di origine.To use this code, uncomment the Option Compare Binary statement, and put it at the top of the source file.

' Option Compare Binary

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

EsempioExample

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.The following example uses the Option Compare statement to set the case-insensitive text sort order as the default string comparison method. Per usare questo codice, rimuovere il commento dall'istruzione Option Compare Text e inserirlo all'inizio del file di origine.To use this code, uncomment the Option Compare Text statement, and put it at the top of the source file.

' Option Compare Text

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

Vedere ancheSee also