Declaração de comparação de opções

  • Artigo

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

Termo 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.

Este tipo de comparação é útil especialmente se as cadeias de caracteres podem conter caracteres que não devem ser interpretados como texto. Nesse caso, você não quer enviesar comparações com equivalências alfabéticas, como insensibilidade a maiúsculas e minúsculas.
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 suas cadeias de caracteres contiverem todos os caracteres de texto e você quiser compará-las levando em conta equivalências alfabéticas, como insensibilidade a maiúsculas e minúsculas e letras intimamente relacionadas. Por exemplo, você pode querer considerar A e a ser igual, e Ää vir antes B e b.

Observações

Se usada, a Option Compare instrução 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 numérico Unicode de cada caractere em cada cadeia de caracteres. Uma Text comparação compara cada caractere Unicode com base em seu significado lexical 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 seguinte ordem de classificação de texto é 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 Option Compare instrução, a configuração Comparação de opções na página de compilação, Project Designer (Visual Basic) será usada. Se você usar o compilador de linha de comando, a configuração especificada pela opção de compilador -optioncompare será usada.

Nota

Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da 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 a Comparação de Opção no IDE

  1. No 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 VB. A configuração padrão inicial em Padrões VB é Binário.

Para definir Comparação de Opção 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, descomente 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 sem diferenciação de maiúsculas e minúsculas como o método de comparação de cadeia de caracteres padrão. Para usar esse código, descomente 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