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

Definição

Espaço de Nomes:
Microsoft.VisualBasic
Assemblagem:
Microsoft.VisualBasic.dll

Devolve -1, 0 ou 1, com base no resultado de uma comparação de cadeias.

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

Required. Qualquer expressão válida String .

String2
String

Required. Qualquer expressão válida String .

Compare
CompareMethod

Optional. Especifica o tipo de comparação de cadeias. Se Compare for omitido, a Option Compare configuração determina o tipo de comparação.

Devoluções

Int32

Um dos seguintes valores:

SeO StrComp retorna
String1 um pouco à frente de String2-1
String1 é igual a String20
String1 mais ou menos depois String21

Exceções

ArgumentException

Compare O valor não é válido.

Exemplos

Este exemplo usa a StrComp função para devolver os resultados de uma comparação de cadeias.

' 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)

Observações

As cadeias são comparadas por valores de ordenação alfanumérica começando pelo primeiro carácter. Para mais informações sobre comparações binárias, comparações textuais e ordem de ordenação, consulte Declaração de Comparação de Opções.

As Compare definições argumentais são:

Constante Descrição
Binary Realiza uma comparação binária, baseada numa ordem de ordenação derivada das representações binárias internas dos caracteres.
Text Faz uma comparação de texto, baseada numa ordem de ordenação de texto insensível a maiúsculas minúsculas e definida pelo valor do LocaleID seu sistema.

Aplica-se a

Ver também