Option Compare (Instrucción)

  • Artículo

Declara el método de comparación predeterminado que se utiliza al comparar datos de cadena.

Sintaxis

Option Compare { Binary | Text }

Partes

Término Definición
Binary Opcional. Genera comparaciones de cadenas basadas en un criterio de ordenación que se deriva de las representaciones binarias internas de los caracteres.

Este tipo de comparación es especialmente útil si las cadenas pueden contener caracteres que no serán interpretados como texto. En este caso, no conviene desviar las comparaciones con equivalencias alfabéticas, como la no distinción entre mayúsculas y minúsculas.
Text Opcional. Genera comparaciones de cadenas basadas en un criterio de ordenación de texto sin distinción entre mayúsculas y minúsculas, determinado por la configuración regional del sistema.

Este tipo de comparación es útil si las cadenas contienen todos los caracteres de texto y si desea compararlas teniendo en cuenta equivalencias alfabéticas, como la no distinción entre mayúsculas y minúsculas y las letras estrechamente relacionadas. Por ejemplo, tal vez le interese considerar que A y a son iguales, y que Ä y ä van antes que B y b.

Comentarios

Si se utiliza la instrucción Option Compare, debe aparecer en un archivo antes que cualquier otra instrucción de código fuente.

La instrucción Option Compare especifica el método de comparación de cadenas (Binary o Text). El método de comparación de texto predeterminado es Binary.

Una comparación Binary compara el valor numérico de Unicode de cada carácter en cada cadena. Una comparación Text compara cada carácter Unicode basándose en su significado léxico en la referencia cultural actual.

En Microsoft Windows, el criterio de ordenación viene determinado por la página de código. Para obtener más información, vea Páginas de códigos.

En el ejemplo siguiente, los caracteres de la página de códigos inglés/europeo (ANSI 1252) se ordenan mediante el uso de Option Compare Binary, lo que genera un criterio de ordenación binario típico.

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

Cuando se ordenan los mismos caracteres en la misma página de código mediante el uso de Option Compare Text, se genera el siguiente criterio de ordenación de texto.

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

Cuando la instrucción Option Compare no está presente

Si el código fuente no contiene una instrucción Option Compare, se utiliza la configuración de Option Compare de Página Compilación, Diseñador de proyectos (Visual Basic). Si usa el compilador de línea de comandos, se utiliza la configuración especificada por la opción del compilador -optioncompare.

Nota:

Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Cómo establecer Option Compare en el IDE

  1. En el Explorador de soluciones, seleccione un proyecto. En el menú Proyecto, haga clic en Propiedades.

  2. Haga clic en la pestaña Compilar.

  3. Establezca el valor en el cuadro Option Compare.

Cuando se crea un proyecto, el valor Option Compare de la pestaña Compilar está establecido en el valor Option Compare del cuadro de diálogo Opciones. Para cambiar esta configuración, en el menú Herramientas, haga clic en Opciones. En el cuadro de diálogo Opciones, expanda Proyectos y soluciones y, después, haga clic en Valores predeterminados de VB. El valor predeterminado inicial de Valores predeterminados de VB es Binario.

Cómo establecer Option Compare en la línea de comandos

Ejemplo 1

El ejemplo siguiente utiliza la instrucción Option Compare para establecer la comparación binaria como método predeterminado de comparación de cadenas. Para utilizar este código, quite el comentario de la instrucción Option Compare Binary y colóquelo en la parte superior del archivo de origen.

' Option Compare Binary

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

Ejemplo 2

El ejemplo siguiente se utiliza la instrucción Option Compare para establecer el criterio de ordenación de texto sin distinción entre mayúsculas y minúsculas como método predeterminado de comparación de cadenas. Para utilizar este código, quite el comentario de la instrucción Option Compare Text y colóquelo en la parte superior del archivo de origen.

' Option Compare Text

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

Consulte también