Оператор Option CompareOption Compare Statement

Объявляет метод сравнения по умолчанию для использования при сравнении строковых данных.Declares the default comparison method to use when comparing string data.

СинтаксисSyntax

Option Compare { Binary | Text }  

ЧастиParts

ТерминTerm ОпределениеDefinition
Binary Необязательный элемент.Optional. Сравнения строк основываются на порядке сортировки, производном от внутренних двоичных представлений символов.Results in string comparisons based on a sort order derived from the internal binary representations of the characters.

Такой тип сравнения наиболее часто применяется, если строки могут содержать символы, которые не следует интерпретировать как текст.This type of comparison is useful especially if the strings can contain characters that are not to be interpreted as text. В этом случае сравнение по алфавитной эквивалентности будет неверным (например, поскольку не будет учитываться регистр).In this case, you do not want to bias comparisons with alphabetical equivalences, such as case insensitivity.
Text Необязательный элемент.Optional. Результаты сравнения строк на основе сортировки текста без учета регистра определяются языком вашей системы.Results in string comparisons based on a case-insensitive text sort order determined by your system's locale.

Такой тип сравнения полезен, если строки содержат только текстовые символы, и нужно сравнить их с учетом алфавитной эквивалентности, то есть без учета регистра и с учетом схожих букв.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. Например, можно считать A и a равными, а Ä и ä должны быть до B и b.For example, you might want to consider A and a to be equal, and Ä and ä to come before B and b.

ПримечанияRemarks

Если используется оператор Option Compare, он должен быть указан в файле до всех прочих операторов.If used, the Option Compare statement must appear in a file before any other source code statements.

Оператор Option Compare указывает метод сравнения строк (Binary или Text).The Option Compare statement specifies the string comparison method (Binary or Text). Метод сравнения текста по умолчанию — Binary.The default text comparison method is Binary.

Сравнение Binary сравнивает числовое значение Юникода каждого символа в каждой строке.A Binary comparison compares the numeric Unicode value of each character in each string. Сравнение Text сравнивает каждый символ Юникода на основе его лексического значения в текущем языке.A Text comparison compares each Unicode character based on its lexical meaning in the current culture.

В Microsoft Windows порядок сортировки определяется кодовой страницей.In Microsoft Windows, sort order is determined by the code page. Дополнительные сведения см. в разделе Кодовые страницы.For more information, see Code Pages.

В следующем примере символы кодовой страницы ANSI 1252 сортируются с помощью оператора Option Compare Binary, создающего двоичный порядок сортировки.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 < À < Ê < Ø < à < ê < ø

Когда эти же символы этой же кодовой страницы сортируются с помощью Option Compare Text, получается следующий порядок сортировки текста.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) < (Ø = ø)

Если оператор Option Compare отсутствуетWhen an Option Compare Statement Is Not Present

Если исходный код не содержит инструкцию Option Compare, то используется параметр сравнить параметр на странице Компиляция, конструктор проектов (Visual Basic) .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. При использовании компилятора командной строки используется параметр, заданный параметром компилятора -оптионкомпаре .If you use the command-line compiler, the setting specified by the -optioncompare compiler option is used.

Примечание

Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в следующих инструкциях.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. Это зависит от имеющегося выпуска Visual Studio и используемых параметров.The Visual Studio edition that you have and the settings that you use determine these elements. Дополнительные сведения см. в разделе Персонализация среды IDE.For more information, see Personalizing the IDE.

Чтобы включить Option Compare в среде разработкиTo set Option Compare in the IDE

  1. Выберите проект в обозревателе решений.In Solution Explorer, select a project. В меню Проект выберите пункт Свойства.On the Project menu, click Properties.

  2. Откройте вкладку Компиляция.Click the Compile tab.

  3. Задайте значение в поле параметр сравнения .Set the value in the Option Compare box.

При создании проекта параметр Option Compare на вкладке Компиляция имеет значение параметр Option Compare в диалоговом окне Параметры .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. Чтобы изменить этот параметр, в меню Сервис выберите пункт Параметры.To change this setting, on the Tools menu, click Options. В диалоговом окне Параметры разверните узел Проекты и решения и выберите пункт Параметры Visual Basic по умолчанию.In the Options dialog box, expand Projects and Solutions, and then click VB Defaults. Начальным значением по умолчанию в VB по умолчанию является binary.The initial default setting in VB Defaults is Binary.

Чтобы включить Option Compare в командной строкеTo set Option Compare on the command line

ПримерExample

В следующем примере оператор Option Compare используется, чтобы задать двоичное сравнение в качестве метода сравнения строк по умолчанию.The following example uses the Option Compare statement to set the binary comparison as the default string comparison method. Чтобы использовать этот код, раскомментируйте оператор Option Compare Binary и поместите его в начало файла исходного кода.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

ПримерExample

В следующем примере оператор Option Compare используется, чтобы задать сортировку текста без учета регистра в качестве метода сравнения строк по умолчанию.The following example uses the Option Compare statement to set the case-insensitive text sort order as the default string comparison method. Чтобы использовать этот код, раскомментируйте оператор Option Compare Text и поместите его в начало файла исходного кода.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

См. такжеSee also