CompareInfo.GetCompareInfo Método

Referência

Definição

Namespace:: System.Globalization

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Assembly:: System.Globalization.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa um novo objeto CompareInfo.

Sobrecargas

GetCompareInfo(Int32)	Inicializa um novo objeto CompareInfo associado à cultura com o identificador especificado.
GetCompareInfo(String)	Inicializa um novo objeto CompareInfo associado à cultura com o nome especificado.
GetCompareInfo(Int32, Assembly)	Inicializa um novo objeto CompareInfo que está associado com a cultura especificada e que usa métodos de comparação de cadeia de caracteres no Assembly especificado.
GetCompareInfo(String, Assembly)	Inicializa um novo objeto CompareInfo que está associado com a cultura especificada e que usa métodos de comparação de cadeia de caracteres no Assembly especificado.

GetCompareInfo(Int32)

Inicializa um novo objeto CompareInfo associado à cultura com o identificador especificado.

public:
 static System::Globalization::CompareInfo ^ GetCompareInfo(int culture);

public static System.Globalization.CompareInfo GetCompareInfo (int culture);

static member GetCompareInfo : int -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (culture As Integer) As CompareInfo

Parâmetros

culture: Int32

Um inteiro que representa o identificador da cultura.

Retornos

CompareInfo

Um novo objeto CompareInfo associado à cultura com o identificador especificado e que usa métodos de comparação de cadeia de caracteres no Assembly atual.

Exemplos

O exemplo a seguir compara partes de duas cadeias de caracteres usando os objetos diferentes CompareInfo :

CompareInfo objeto associado à cultura espanhola (Espanha) com classificação internacional
CompareInfo objeto associado à cultura espanhola (Espanha) com classificação tradicional
CompareInfo objeto associado ao InvariantCulture

// The following code example compares two strings using the different CompareInfo instances:
//    a CompareInfo instance associated with the S"Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the S"Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.
using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the strings to compare.
   String^ myStr1 = "calle";
   String^ myStr2 = "calor";
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"es-ES" culture with international sort.
   CompareInfo^ myCompIntl = CompareInfo::GetCompareInfo( "es-ES" );
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"es-ES" culture with traditional sort.
   CompareInfo^ myCompTrad = CompareInfo::GetCompareInfo( 0x040A );
   
   // Uses the CompareInfo property of the InvariantCulture.
   CompareInfo^ myCompInva = CultureInfo::InvariantCulture->CompareInfo;
   
   // Compares two strings using myCompIntl.
   Console::WriteLine( "Comparing \"{0}\" and \"{1}\"", myStr1, myStr2 );
   Console::WriteLine( "   With myCompIntl::Compare: {0}", myCompIntl->Compare( myStr1, myStr2 ) );
   Console::WriteLine( "   With myCompTrad::Compare: {0}", myCompTrad->Compare( myStr1, myStr2 ) );
   Console::WriteLine( "   With myCompInva::Compare: {0}", myCompInva->Compare( myStr1, myStr2 ) );
}

/*
This code produces the following output.

Comparing "calle" and "calor"
   With myCompIntl::Compare: -1
   With myCompTrad::Compare: 1
   With myCompInva::Compare: -1
*/

// The following code example compares two strings using the different CompareInfo instances:
//    a CompareInfo instance associated with the "Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the "Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "calor";

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with international sort.
      CompareInfo myCompIntl = CompareInfo.GetCompareInfo( "es-ES" );

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      CompareInfo myCompTrad = CompareInfo.GetCompareInfo( 0x040A );

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myCompInva = CultureInfo.InvariantCulture.CompareInfo;

      // Compares two strings using myCompIntl.
      Console.WriteLine( "Comparing \"{0}\" and \"{1}\"", myStr1, myStr2 );
      Console.WriteLine( "   With myCompIntl.Compare: {0}", myCompIntl.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompTrad.Compare: {0}", myCompTrad.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompInva.Compare: {0}", myCompInva.Compare( myStr1, myStr2 ) );
   }
}


/*
This code produces the following output.

Comparing "calle" and "calor"
   With myCompIntl.Compare: -1
   With myCompTrad.Compare: 1
   With myCompInva.Compare: -1

*/

' The following code example compares two strings using the different CompareInfo instances:
'    a CompareInfo instance associated with the "Spanish - Spain" culture with international sort,
'    a CompareInfo instance associated with the "Spanish - Spain" culture with traditional sort, and
'    a CompareInfo instance associated with the InvariantCulture.

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "calor"

      ' Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with international sort.
      Dim myCompIntl As CompareInfo = CompareInfo.GetCompareInfo("es-ES")

      ' Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      Dim myCompTrad As CompareInfo = CompareInfo.GetCompareInfo(&H40A)

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myCompInva As CompareInfo = CultureInfo.InvariantCulture.CompareInfo

      ' Compares two strings using myCompIntl.
      Console.WriteLine("Comparing ""{0}"" and ""{1}""", myStr1, myStr2)
      Console.WriteLine("   With myCompIntl.Compare: {0}", myCompIntl.Compare(myStr1, myStr2))
      Console.WriteLine("   With myCompTrad.Compare: {0}", myCompTrad.Compare(myStr1, myStr2))
      Console.WriteLine("   With myCompInva.Compare: {0}", myCompInva.Compare(myStr1, myStr2))

   End Sub

End Class


'This code produces the following output.
'
'Comparing "calle" and "calor"
'   With myCompIntl.Compare: -1
'   With myCompTrad.Compare: 1
'   With myCompInva.Compare: -1

Aplica-se a

GetCompareInfo(String)

Inicializa um novo objeto CompareInfo associado à cultura com o nome especificado.

public:
 static System::Globalization::CompareInfo ^ GetCompareInfo(System::String ^ name);

public static System.Globalization.CompareInfo GetCompareInfo (string name);

static member GetCompareInfo : string -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (name As String) As CompareInfo

Parâmetros

name: String

Uma cadeia de caracteres que representa o nome da cultura.

Retornos

CompareInfo

Um novo objeto CompareInfo associado à cultura com o identificador especificado e que usa métodos de comparação de cadeia de caracteres no Assembly atual.

Exceções

ArgumentNullException

name é null.

ArgumentException

name é um nome de cultura inválido.

Exemplos

O exemplo a seguir compara partes de duas cadeias de caracteres usando os objetos diferentes CompareInfo :

CompareInfo objeto associado à cultura espanhola (Espanha) com classificação internacional
CompareInfo objeto associado à cultura espanhola (Espanha) com classificação tradicional
CompareInfo objeto associado ao InvariantCulture

// The following code example compares two strings using the different CompareInfo instances:
//    a CompareInfo instance associated with the S"Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the S"Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.
using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the strings to compare.
   String^ myStr1 = "calle";
   String^ myStr2 = "calor";
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"es-ES" culture with international sort.
   CompareInfo^ myCompIntl = CompareInfo::GetCompareInfo( "es-ES" );
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"es-ES" culture with traditional sort.
   CompareInfo^ myCompTrad = CompareInfo::GetCompareInfo( 0x040A );
   
   // Uses the CompareInfo property of the InvariantCulture.
   CompareInfo^ myCompInva = CultureInfo::InvariantCulture->CompareInfo;
   
   // Compares two strings using myCompIntl.
   Console::WriteLine( "Comparing \"{0}\" and \"{1}\"", myStr1, myStr2 );
   Console::WriteLine( "   With myCompIntl::Compare: {0}", myCompIntl->Compare( myStr1, myStr2 ) );
   Console::WriteLine( "   With myCompTrad::Compare: {0}", myCompTrad->Compare( myStr1, myStr2 ) );
   Console::WriteLine( "   With myCompInva::Compare: {0}", myCompInva->Compare( myStr1, myStr2 ) );
}

/*
This code produces the following output.

Comparing "calle" and "calor"
   With myCompIntl::Compare: -1
   With myCompTrad::Compare: 1
   With myCompInva::Compare: -1
*/

// The following code example compares two strings using the different CompareInfo instances:
//    a CompareInfo instance associated with the "Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the "Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "calor";

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with international sort.
      CompareInfo myCompIntl = CompareInfo.GetCompareInfo( "es-ES" );

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      CompareInfo myCompTrad = CompareInfo.GetCompareInfo( 0x040A );

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myCompInva = CultureInfo.InvariantCulture.CompareInfo;

      // Compares two strings using myCompIntl.
      Console.WriteLine( "Comparing \"{0}\" and \"{1}\"", myStr1, myStr2 );
      Console.WriteLine( "   With myCompIntl.Compare: {0}", myCompIntl.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompTrad.Compare: {0}", myCompTrad.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompInva.Compare: {0}", myCompInva.Compare( myStr1, myStr2 ) );
   }
}


/*
This code produces the following output.

Comparing "calle" and "calor"
   With myCompIntl.Compare: -1
   With myCompTrad.Compare: 1
   With myCompInva.Compare: -1

*/

' The following code example compares two strings using the different CompareInfo instances:
'    a CompareInfo instance associated with the "Spanish - Spain" culture with international sort,
'    a CompareInfo instance associated with the "Spanish - Spain" culture with traditional sort, and
'    a CompareInfo instance associated with the InvariantCulture.

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "calor"

      ' Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with international sort.
      Dim myCompIntl As CompareInfo = CompareInfo.GetCompareInfo("es-ES")

      ' Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      Dim myCompTrad As CompareInfo = CompareInfo.GetCompareInfo(&H40A)

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myCompInva As CompareInfo = CultureInfo.InvariantCulture.CompareInfo

      ' Compares two strings using myCompIntl.
      Console.WriteLine("Comparing ""{0}"" and ""{1}""", myStr1, myStr2)
      Console.WriteLine("   With myCompIntl.Compare: {0}", myCompIntl.Compare(myStr1, myStr2))
      Console.WriteLine("   With myCompTrad.Compare: {0}", myCompTrad.Compare(myStr1, myStr2))
      Console.WriteLine("   With myCompInva.Compare: {0}", myCompInva.Compare(myStr1, myStr2))

   End Sub

End Class


'This code produces the following output.
'
'Comparing "calle" and "calor"
'   With myCompIntl.Compare: -1
'   With myCompTrad.Compare: 1
'   With myCompInva.Compare: -1

Aplica-se a

GetCompareInfo(Int32, Assembly)

Inicializa um novo objeto CompareInfo que está associado com a cultura especificada e que usa métodos de comparação de cadeia de caracteres no Assembly especificado.

public:
 static System::Globalization::CompareInfo ^ GetCompareInfo(int culture, System::Reflection::Assembly ^ assembly);

public static System.Globalization.CompareInfo GetCompareInfo (int culture, System.Reflection.Assembly assembly);

static member GetCompareInfo : int * System.Reflection.Assembly -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (culture As Integer, assembly As Assembly) As CompareInfo

Parâmetros

culture: Int32

Um inteiro que representa o identificador da cultura.

assembly: Assembly

Um Assembly que contém os métodos de comparação de cadeia de caracteres a serem usados.

Retornos

CompareInfo

Um novo objeto CompareInfo associado à cultura com o identificador especificado e que usa métodos de comparação de cadeia de caracteres no Assembly atual.

Exceções

ArgumentNullException

assembly é null.

ArgumentException

assembly pertence a um tipo inválido.

Comentários

Observação

O comportamento desse método é imprevisível. É recomendável que seu aplicativo use uma versão desse método que não usa uma entrada de assembly.

O assembly parâmetro deve ser do mesmo tipo que Module.Assembly.

Confira também

Assembly

Aplica-se a

GetCompareInfo(String, Assembly)

Inicializa um novo objeto CompareInfo que está associado com a cultura especificada e que usa métodos de comparação de cadeia de caracteres no Assembly especificado.

public:
 static System::Globalization::CompareInfo ^ GetCompareInfo(System::String ^ name, System::Reflection::Assembly ^ assembly);

public static System.Globalization.CompareInfo GetCompareInfo (string name, System.Reflection.Assembly assembly);

static member GetCompareInfo : string * System.Reflection.Assembly -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (name As String, assembly As Assembly) As CompareInfo

Parâmetros

name: String

Uma cadeia de caracteres que representa o nome da cultura.

assembly: Assembly

Um Assembly que contém os métodos de comparação de cadeia de caracteres a serem usados.

Retornos

CompareInfo

Um novo objeto CompareInfo associado à cultura com o identificador especificado e que usa métodos de comparação de cadeia de caracteres no Assembly atual.

Exceções

ArgumentNullException

name é null.

- ou -

assembly é null.

ArgumentException

name é um nome de cultura inválido.

- ou -

assembly pertence a um tipo inválido.

Comentários

Observação

O comportamento desse método é imprevisível. Recomendamos que você use uma versão desse método que não use uma entrada de assembly.

O assembly parâmetro deve ser do mesmo tipo que Module.Assembly.

Confira também

Assembly

Aplica-se a

CompareInfo.GetCompareInfo Método

Definição

Sobrecargas

GetCompareInfo(Int32)

Parâmetros

Retornos

Exemplos

Aplica-se a

GetCompareInfo(String)

Parâmetros

Retornos

Exceções

Exemplos

Aplica-se a

GetCompareInfo(Int32, Assembly)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

GetCompareInfo(String, Assembly)

Parâmetros

Retornos

Exceções

Comentários

Confira também

Aplica-se a

Recursos adicionais