Option Compare (Instrucción)Option Compare Statement

Declara el método de comparación predeterminado que se utiliza al comparar datos de cadena.Declares the default comparison method to use when comparing string data.

SintaxisSyntax

Option Compare { Binary | Text }  

ElementosParts

TérminoTerm DefiniciónDefinition
Binary Opcional.Optional. Genera comparaciones de cadenas basadas en un criterio de ordenación que se deriva de las representaciones binarias internas de los caracteres.Results in string comparisons based on a sort order derived from the internal binary representations of the characters.

Este tipo de comparación es especialmente útil si las cadenas pueden contener caracteres que no serán interpretados como texto.This type of comparison is useful especially if the strings can contain characters that are not to be interpreted as text. En este caso, no conviene desviar las comparaciones con equivalencias alfabéticas, como la no distinción entre mayúsculas y minúsculas.In this case, you do not want to bias comparisons with alphabetical equivalences, such as case insensitivity.
Text Opcional.Optional. 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.Results in string comparisons based on a case-insensitive text sort order determined by your system's locale.

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.This type of comparison is useful if your strings contain all text characters, and you want to compare them taking into account alphabetic equivalences such as case insensitivity and closely related letters. Por ejemplo, tal vez le interese considerar que A y a son iguales, y que Ä y ä van antes que B y b.For example, you might want to consider A and a to be equal, and Ä and ä to come before B and b.

ComentariosRemarks

Si se utiliza la instrucción Option Compare, debe aparecer en un archivo antes que cualquier otra instrucción de código fuente.If used, the Option Compare statement must appear in a file before any other source code statements.

La instrucción Option Compare especifica el método de comparación de cadenas (Binary o Text).The Option Compare statement specifies the string comparison method (Binary or Text). El método de comparación de texto predeterminado es Binary.The default text comparison method is Binary.

Una comparación Binary compara el valor numérico de Unicode de cada carácter en cada cadena.A Binary comparison compares the numeric Unicode value of each character in each string. Una comparación Text compara cada carácter Unicode basándose en su significado léxico en la referencia cultural actual.A Text comparison compares each Unicode character based on its lexical meaning in the current culture.

En Microsoft Windows, el criterio de ordenación viene determinado por la página de código.In Microsoft Windows, sort order is determined by the code page. Para obtener más información, vea Páginas de códigos.For more information, see Code Pages.

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.In the following example, characters in the English/European code page (ANSI 1252) are sorted by using Option Compare Binary, which produces a typical binary sort order.

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.When the same characters in the same code page are sorted by using Option Compare Text, the following text sort order is produced.

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

Cuando la instrucción Option Compare no está presenteWhen an Option Compare Statement Is Not Present

Si el código fuente no contiene una instrucción Option Compare, se usa el valor Option Compare en la Página compilar, el diseñador de proyectos (Visual Basic) .If the source code does not contain an Option Compare statement, the Option Compare setting on the Compile Page, Project Designer (Visual Basic) is used. Si usa el compilador de línea de comandos, se usa el valor especificado por la opción del compilador -optioncompare ( .If you use the command-line compiler, the setting specified by the -optioncompare compiler option is used.

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.Your computer might show different names or locations for some of the Visual Studio user interface elements in the following instructions. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos.The Visual Studio edition that you have and the settings that you use determine these elements. Para obtener más información, vea Personalizar el IDE.For more information, see Personalizing the IDE.

Cómo establecer Option Compare en el IDETo set Option Compare in the IDE

  1. En el Explorador de soluciones, seleccione un proyecto.In Solution Explorer, select a project. En el menú Proyecto, haga clic en Propiedades.On the Project menu, click Properties.

  2. Haga clic en la pestaña Compilar.Click the Compile tab.

  3. Establezca el valor en el cuadro Option Compare .Set the value in the Option Compare box.

Al crear un proyecto, el valor Option Compare de la pestaña compilar se establece en el valor Option Compare del cuadro de diálogo Opciones .When you create a project, the Option Compare setting on the Compile tab is set to the Option Compare setting in the Options dialog box. Para cambiar esta configuración, en el menú herramientas , haga clic en Opciones.To change this setting, on the Tools menu, click Options. En el cuadro de diálogo Opciones, expanda Proyectos y soluciones y, después, haga clic en Valores predeterminados de VB.In the Options dialog box, expand Projects and Solutions, and then click VB Defaults. La configuración predeterminada inicial en los valores predeterminados de VB es binaria.The initial default setting in VB Defaults is Binary.

Cómo establecer Option Compare en la línea de comandosTo set Option Compare on the command line

EjemploExample

El ejemplo siguiente utiliza la instrucción Option Compare para establecer la comparación binaria como método predeterminado de comparación de cadenas.The following example uses the Option Compare statement to set the binary comparison as the default string comparison method. 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.To use this code, uncomment the Option Compare Binary statement, and put it at the top of the source file.

' Option Compare Binary

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

EjemploExample

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.The following example uses the Option Compare statement to set the case-insensitive text sort order as the default string comparison method. 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.To use this code, uncomment the Option Compare Text statement, and put it at the top of the source file.

' Option Compare Text

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

Vea tambiénSee also