Compartilhar via

Instrução Option Compare

Declara o método de comparação padrão a ser usado ao comparar dados de cadeia de caracteres.

Sintaxe

Option Compare { Binary | Text }

Partes

Prazo Definição
Binary Opcional. Resulta em comparações de cadeia de caracteres com base em uma ordem de classificação derivada das representações binárias internas dos caracteres.

Esse tipo de comparação é útil especialmente se as cadeias de caracteres puderem conter caracteres que não devem ser interpretados como texto. Nesse caso, você não deseja diferenciar comparações com equivalências alfabéticas, como insensibilidade de caso.
Text Opcional. Resulta em comparações de cadeia de caracteres com base em uma ordem de classificação de texto que não diferencia maiúsculas de minúsculas determinada pela localidade do sistema.

Esse tipo de comparação é útil se as cadeias de caracteres contiverem todos os caracteres de texto e você quiser compará-los levando em conta equivalências alfabéticas, como insensibilidade de caso e letras intimamente relacionadas. Por exemplo, talvez você queira considerar A e a ser igual e Ää vir antes B e b.

Observações

Se usada, a instrução Option Compare deve aparecer em um arquivo antes de qualquer outra instrução de código-fonte.

A Option Compare instrução especifica o método de comparação de cadeia de caracteres (Binary ou Text). O método de comparação de texto padrão é Binary.

Uma Binary comparação compara o valor Unicode numérico de cada caractere em cada cadeia de caracteres. Uma Text comparação compara cada caractere Unicode com base em seu significado léxico na cultura atual.

No Microsoft Windows, a ordem de classificação é determinada pela página de código. Para obter mais informações, consulte Páginas de Código.

No exemplo a seguir, os caracteres na página de código inglês/europeu (ANSI 1252) são classificados usando Option Compare Binary, o que produz uma ordem de classificação binária típica.

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

Quando os mesmos caracteres na mesma página de código são classificados usando Option Compare Text, a ordem de classificação de texto a seguir é produzida.

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

Quando uma instrução Option Compare não está presente

Se o código-fonte não contiver uma instrução Option Compare , a configuração Comparação de Opções na Página compilar, o Designer de Projeto (Visual Basic) será usado. Se você usar o compilador de linha de comando, a configuração especificada pela opção do compilador -optioncompare será usada.

Observação

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você tem e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando o IDE.

Para definir o Option Compare no IDE

  1. Em do Gerenciador de Soluções, selecione um projeto. No menu Projeto, clique em Propriedades.

  2. Clique na guia Compilar.

  3. Defina o valor na caixa Comparação de Opções .

Quando você cria um projeto, a configuração Comparação de Opções na guia Compilar é definida como a configuração Comparação de Opções na caixa de diálogo Opções . Para alterar essa configuração, no menu Ferramentas , clique em Opções. Na caixa de diálogo Opções , expanda Projetos e Soluções e clique em Padrões do VB. A configuração padrão inicial em Padrões de VB é Binária.

Para definir o Option Compare na linha de comando

Exemplo 1

O exemplo a seguir usa a Option Compare instrução para definir a comparação binária como o método de comparação de cadeia de caracteres padrão. Para usar esse código, descompacte a Option Compare Binary instrução e coloque-a na parte superior do arquivo de origem.

' Option Compare Binary

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

Exemplo 2

O exemplo a seguir usa a Option Compare instrução para definir a ordem de classificação de texto que não diferencia maiúsculas de minúsculas como o método de comparação de cadeia de caracteres padrão. Para usar esse código, descompacte a Option Compare Text instrução e coloque-a na parte superior do arquivo de origem.

' Option Compare Text

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

Consulte também

  • Last updated on