Option Compare (Instrucción)
Declara el método de comparación predeterminado que utilizar al comparar los datos de cadena.
Option Compare { Binary | Text }
Partes
Término |
Definición |
Binary |
Opcional. Se producirán 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 se desea afectar a las comparaciones con equivalencias alfabéticas, como la distinción entre mayúsculas y minúsculas. |
Text |
Opcional. Se producirán comparaciones de cadenas basadas en un texto que utiliza un criterio de ordenación que no distingue entre mayúsculas y minúsculas y que se basa en la configuración de idioma del sistema. Este tipo de comparación es útil si las cadenas contienen únicamente caracteres de texto y desea compararlas teniendo en cuenta las equivalencias alfabéticas como la no distinción entre mayúsculas y minúsculas y las letras estrechamente relacionadas. Por ejemplo, podría considerar A y a como iguales y Ä y ä como anteriores a B y b. |
Comentarios
Si se utiliza, la instrucción Option Compare tiene que 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 predeterminado de comparación de texto es Binary.
Una comparación Binary compara el valor Unicode numérico de cada carácter en cada cadena. Una comparación de Text compara cada carácter Unicode en función de 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ódigos. Para obtener más información, vea Code Pages.
En el ejemplo siguiente, los caracteres de la página de códigos (ANSI 1252) de inglés/europeo se ordenan mediante Option Compare Binary, que genera un criterio de ordenación binario típico.
A < B < E < Z < a < b < e < z < À < Ê < Ø < à < ê < ø
Cuando esos mismos caracteres de la misma página de códigos se ordenan con Option Compare Text, se genera el criterio de ordenación de texto siguiente.
(A=a) < (À = à) < (B=b) < (E=e) < (Ê = ê) < (Z=z) < (Ø = ø)
Cuando no existe una instrucción Option Compare
Si el código fuente no contiene una instrucción Option Compare, se utiliza el valor de Option Compare en Página Compilación, Diseñador de proyectos (Visual Basic). Si se usa el compilador de la línea de comandos, se utiliza la configuración especificada por la opción del compilador /optioncompare.
Nota
Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio incluidos en las instrucciones siguientes. 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 Valores de configuración de Visual Studio.
Para establecer Option Compare en el IDE
En el Explorador de soluciones, seleccione un proyecto. En el menú Proyecto, haga clic en Propiedades. Para obtener más información, vea Introducción al Diseñador de proyectos.
Haga clic en la ficha Compilar.
Establezca el valor en el cuadro Option Compare.
Cuando se crea un proyecto, el valor de Option Compare en la pestaña Compilar se establece en el valor de 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, a continuación, haga clic en Valores predeterminados de VB. El valor predeterminado inicial en Valores predeterminados de VB es Binary.
Para establecer Option Compare en la línea de comandos
- Incluya la opción del compilador /optioncompare en el comando vbc.
Ejemplo
El ejemplo siguiente utiliza la instrucción Option Compare para establecer la comparación binaria como el método predeterminado de comparación de cadenas. Para usar este código, quite la marca de comentario de la instrucción Option Compare Binary, y colóquelo en la parte superior del archivo de código fuente.
' Set the string comparison method to Binary ("AAA" < "aaa").
Option Compare Binary
El ejemplo siguiente 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 el método de comparación de cadenas predeterminado. Para usar este código, quite la marca de comentario de la instrucción Option Compare Text, y colóquelo en la parte superior del archivo de código fuente.
' Set the string comparison method to Text ("AAA" = "aaa").
Option Compare Text
Vea también
Referencia
Operadores de comparación (Visual Basic)
Funciones de cadena (Visual Basic)
Option Explicit (Instrucción, Visual Basic)