Instrução Option Compare
Declara o método padrão de comparação a ser usado ao comparar dados da cadeia de caracteres.
Option Compare { Binary | Text }
Partes
Termo |
Definição |
Binary |
Opcional. Resulta em comparações de cadeias 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 principalmente se as cadeias de caracteres puderem conter caracteres que não serão interpretados como texto. Nesse caso, você não deseja ajustar comparações com equivalentes em ordem alfabética, como maiúsculas e minúsculas. |
Text |
Opcional. Resulta em comparações de cadeias de caracteres com base em uma ordem de classificação de texto com diferenciação de maiúsculas de minúsculas determinada pela localidade do sistema. Esse tipo de comparação é útil se suas cadeias de caracteres tiverem todos os caracteres de texto e você desejar compará-las levando em conta equivalências alfabéticas como maiúsculas e minúsculas e letras relacionadas. Por exemplo, você pode desejar considerar que A e a sejam iguais, e que Ä e ä venham antes de B e b. |
Comentários
Se usado, a instrução Option Compare deve aparecer em um arquivo antes de quaisquer outras instruções de código-fonte.
A instrução Option Compare 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.
A comparação Binary compara o valor de Unicode numérico de cada caractere em cadeia de caracteres. A comparação Text compara cada caractere Unicode com base em seu sentido 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, 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 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 tiver uma instrução Option Compare, a configuração Option Compare no Página de Compilação, Designer de Projeto (Visual Basic) é usada. Se você usar o compilador de linha de comando, a configuração especificada pela opção do compilador /optioncompare é usada.
Dica
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ê possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.
Para definir o Option Compare no IDE
No Gerenciador de Soluções, selecione um projeto. No menu Projeto, clique em Propriedades. Para obter mais informações, consulte Introduction to the Project Designer.
Clique na guia Compilar.
Defina o valor na caixa Option Compare.
Ao criar um novo projeto, a configuração Option Compare na guia Compilar é definida para a configuração Option Compare 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, em seguida, clique em Padrões de VB. A configuração inicial padrão nos Padrões de VB é Binária.
Para definir o Option Compare na linha de comando
- Inclui a opção do compilador /optioncompare no comando vbc.
Exemplo
O exemplo a seguir usa a instrução Option Compare para definir a comparação binária como o método padrão de comparação de cadeia de caracteres. Para usar esse código, retire os comentários da instrução Option Compare Binary e coloque-os na parte superior do arquivo de origem.
' Option Compare Binary
Console.WriteLine("A" < "a")
' Output: True
O exemplo a seguir usa a instrução Option Compare para definir a ordem de classificação sem diferenciação de maiúsculas de minúsculas como o método padrão de comparação de cadeia de caracteres. Para usar esse código, retire os comentários da instrução Option Compare Text e coloque-os na parte superior do arquivo de origem.
' Option Compare Text
Console.WriteLine("A" = "a")
' Output: True
Consulte também
Referência
Operadores de comparação (Visual Basic)
Funções da cadeia de caracteres (Visual Basic)
Instrução Option Explicit (Visual Basic)