Comparer Classe

Definição

public ref class Comparer sealed : System::Collections::IComparer

public ref class Comparer sealed : System::Collections::IComparer, System::Runtime::Serialization::ISerializable

public sealed class Comparer : System.Collections.IComparer

public sealed class Comparer : System.Collections.IComparer, System.Runtime.Serialization.ISerializable

[System.Serializable]
public sealed class Comparer : System.Collections.IComparer, System.Runtime.Serialization.ISerializable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Comparer : System.Collections.IComparer, System.Runtime.Serialization.ISerializable

type Comparer = class
    interface IComparer

type Comparer = class
    interface IComparer
    interface ISerializable

[<System.Serializable>]
type Comparer = class
    interface IComparer
    interface ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Comparer = class
    interface IComparer
    interface ISerializable

Public NotInheritable Class Comparer
Implements IComparer

Public NotInheritable Class Comparer
Implements IComparer, ISerializable

Herança

Object

Comparer

Atributos

SerializableAttribute ComVisibleAttribute

Implementações

IComparer ISerializable

Exemplos

O seguinte exemplo de código mostra como Compare retorna diferentes valores dependendo da cultura associada ao Comparer.

using System;
using System.Collections;
using System.Globalization;

public class SamplesComparer  {

   public static void Main()  {

      // Creates the strings to compare.
      String str1 = "llegar";
      String str2 = "lugar";
      Console.WriteLine( "Comparing \"{0}\" and \"{1}\" ...", str1, str2 );

      // Uses the DefaultInvariant Comparer.
      Console.WriteLine( "   Invariant Comparer: {0}", Comparer.DefaultInvariant.Compare( str1, str2 ) );

      // Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
      Comparer myCompIntl = new Comparer( new CultureInfo( "es-ES", false ) );
      Console.WriteLine( "   International Sort: {0}", myCompIntl.Compare( str1, str2 ) );

      // Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
      Comparer myCompTrad = new Comparer( new CultureInfo( 0x040A, false ) );
      Console.WriteLine( "   Traditional Sort  : {0}", myCompTrad.Compare( str1, str2 ) );
   }
}

/*
This code produces the following output.

Comparing "llegar" and "lugar" ...
   Invariant Comparer: -1
   International Sort: -1
   Traditional Sort  : 1

*/

Imports System.Collections
Imports System.Globalization

Public Class SamplesComparer

   Public Shared Sub Main()

      ' Creates the strings to compare.
      Dim str1 As [String] = "llegar"
      Dim str2 As [String] = "lugar"
      Console.WriteLine("Comparing ""{0}"" and ""{1}"" ...", str1, str2)

      ' Uses the DefaultInvariant Comparer.
      Console.WriteLine("   Invariant Comparer: {0}", Comparer.DefaultInvariant.Compare(str1, str2))

      ' Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
      Dim myCompIntl As New Comparer(New CultureInfo("es-ES", False))
      Console.WriteLine("   International Sort: {0}", myCompIntl.Compare(str1, str2))

      ' Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
      Dim myCompTrad As New Comparer(New CultureInfo(&H40A, False))
      Console.WriteLine("   Traditional Sort  : {0}", myCompTrad.Compare(str1, str2))

   End Sub

End Class


'This code produces the following output.
'
'Comparing "llegar" and "lugar" ...
'   Invariant Comparer: -1
'   International Sort: -1
'   Traditional Sort  : 1

Observações

Esta classe é a implementação padrão da IComparer interface. A CaseInsensitiveComparer classe é a implementação da IComparer interface que realiza comparações de cadeias insensíveis a maiúsculas e minúsculas. System.Collections.Generic.Comparer<T> é o equivalente genérico desta classe.

Os procedimentos de comparação utilizam o Thread.CurrentCulture do tópico atual, salvo indicação em contrário. As comparações de cordas podem ter resultados diferentes dependendo da cultura. Para mais informações sobre comparações específicas de culturas, consulte o System.Globalization namespace e Globalização e Localização.

Ver também

• IComparer
• IComparable
• CaseInsensitiveComparer
• Comparer<T>
• CompareInfo
• CurrentCulture
• CultureInfo