Strings.StrComp(String, String, CompareMethod) Método

Definición

Espacio de nombres:

Microsoft.VisualBasic

Ensamblado:

Microsoft.VisualBasic.Core.dll

Source:

Strings.vb

Devuelve un valor, -1, 0 ó 1, que indica el resultado de una comparación de cadena.

public static int StrComp (string? String1, string? String2, Microsoft.VisualBasic.CompareMethod Compare = Microsoft.VisualBasic.CompareMethod.Binary);

static member StrComp : string * string * Microsoft.VisualBasic.CompareMethod -> int

Public Function StrComp (String1 As String, String2 As String, Optional Compare As CompareMethod = Microsoft.VisualBasic.CompareMethod.Binary) As Integer

Parámetros

String1

String

Obligatorio. Cualquier expresión String válida.

String2

String

Obligatorio. Cualquier expresión String válida.

Compare

CompareMethod

Opcional. Especifica el tipo de comparación de cadenas. Si se omite Compare, la configuración de Option Compare determina el tipo de comparación.

Devoluciones

Int32

Uno de los siguientes valores:

Si	StrComp devuelve
String1 se ordena delante de String2	-1
String1 es igual a String2	0
String1 se ordena después de String2	1

Excepciones

ArgumentException

El valor de Compare no es válido.

Ejemplos

En este ejemplo se usa la StrComp función para devolver los resultados de una comparación de cadenas.

' Defines variables.
Dim testStr1 As String = "ABCD"
Dim testStr2 As String = "abcd"
Dim testComp As Integer
' The two strings sort equally. Returns 0.
testComp = StrComp(testStr1, testStr2, CompareMethod.Text)
' testStr1 sorts before testStr2. Returns -1.
testComp = StrComp(testStr1, testStr2, CompareMethod.Binary)
' testStr2 sorts after testStr1. Returns 1.
testComp = StrComp(testStr2, testStr1, CompareMethod.Binary)

Comentarios

Las cadenas se comparan mediante valores de ordenación alfanuméricos que comienzan por el primer carácter. Para obtener más información sobre las comparaciones binarias, las comparaciones textuales y el criterio de ordenación, vea Option Compare Statement.

La configuración del argumento Compare es:

Constante	Descripción
Binary	Realiza una comparación binaria, basada en un criterio de ordenación derivado de las representaciones binarias internas de los caracteres.
Text	Realiza una comparación de texto, en función de un criterio de ordenación de texto sin distinción entre mayúsculas y minúsculas determinado por el valor del LocaleID sistema.

Consulte también

• InStr
• ArgumentException
• Resumen de la manipulación de cadenas
• Cadenas en Visual Basic
• Introducción a las cadenas en Visual Basic