Comparer Klass

Definition

Namnområde:
System.Collections
Sammansättningar:
mscorlib.dll, System.Collections.NonGeneric.dll
Sammansättning:
mscorlib.dll
Sammansättning:
netstandard.dll

Jämför två objekt för likvärdighet, där strängjämförelser är skiftlägeskänsliga.

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
[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
public sealed class Comparer : System.Collections.IComparer, System.Runtime.Serialization.ISerializable
type Comparer = class
    interface IComparer
[<System.Serializable>]
type Comparer = class
    interface IComparer
    interface ISerializable
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Comparer = class
    interface IComparer
    interface ISerializable
type Comparer = class
    interface IComparer
    interface ISerializable
Public NotInheritable Class Comparer
Implements IComparer
Public NotInheritable Class Comparer
Implements IComparer, ISerializable
Arv
Object
Comparer
Attribut
SerializableAttribute ComVisibleAttribute
Implementeringar
IComparer ISerializable

Exempel

Följande kodexempel visar hur Compare returnerar olika värden beroende på kulturen som är associerad med 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

Kommentarer

Den här klassen är standardimplementeringen av IComparer gränssnittet. Klassen CaseInsensitiveComparer är implementeringen av gränssnittet IComparer som utför skiftlägesokänsliga strängjämförelser. System.Collections.Generic.Comparer<T> är den allmänna motsvarigheten till den här klassen.

Jämförelseprocedurer använder den Thread.CurrentCulture aktuella tråden om inget annat anges. Strängjämförelser kan ha olika resultat beroende på kulturen. Mer information om kulturspecifika jämförelser finns i System.Globalization namnområdet och Globalisering och lokalisering.

Konstruktorer

Name Description
Comparer(CultureInfo)

Initierar en ny instans av Comparer klassen med den angivna CultureInfo.

Fält

Name Description
Default

Representerar en instans av Comparer som är associerad med den CurrentCulture aktuella tråden. Detta fält är skrivskyddat.
DefaultInvariant

Representerar en instans av Comparer som är associerad med InvariantCulture. Detta fält är skrivskyddat.

Metoder

Name Description
Compare(Object, Object)

Utför en skiftlägeskänslig jämförelse av två objekt av samma typ och returnerar ett värde som anger om det ena är mindre än, lika med eller större än det andra.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetObjectData(SerializationInfo, StreamingContext)

Fyller i ett SerializationInfo objekt med de data som krävs för serialisering.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även