Tuple<T1,T2,T3,T4,T5,T6>.IStructuralEquatable.Equals(Object, IEqualityComparer) Tuple<T1,T2,T3,T4,T5,T6>.IStructuralEquatable.Equals(Object, IEqualityComparer) Tuple<T1,T2,T3,T4,T5,T6>.IStructuralEquatable.Equals(Object, IEqualityComparer) Method

Definição

Retorna um valor que indica se o objeto Tuple<T1,T2,T3,T4,T5,T6> atual é igual ao objeto especificado com base em um determinado método de comparação.Returns a value that indicates whether the current Tuple<T1,T2,T3,T4,T5,T6> object is equal to a specified object based on a specified comparison method.

 virtual bool System.Collections.IStructuralEquatable.Equals(System::Object ^ other, System::Collections::IEqualityComparer ^ comparer) = System::Collections::IStructuralEquatable::Equals;
bool IStructuralEquatable.Equals (object other, System.Collections.IEqualityComparer comparer);
Function Equals (other As Object, comparer As IEqualityComparer) As Boolean Implements IStructuralEquatable.Equals

Parâmetros

other
Object Object Object

O objeto a ser comparado com essa instância.The object to compare with this instance.

comparer
IEqualityComparer IEqualityComparer IEqualityComparer

Um objeto que define o método a ser usado para avaliar se dois objetos são iguais.An object that defines the method to use to evaluate whether the two objects are equal.

Retornos

true caso a instância atual seja igual ao objeto especificado; do contrário, false.true if the current instance is equal to the specified object; otherwise, false.

Implementações

Exemplos

O exemplo a seguir define RateComparer uma classe que executa um teste personalizado para igualdade.The following example defines a RateComparer class that performs a custom test for equality. Se os valores passados para seu IStructuralEquatable.Equals método forem do tipo Single ou Double, o método testará a igualdade usando apenas até três dígitos fracionários.If the values that are passed to its IStructuralEquatable.Equals method are of type Single or Double, the method tests for equality by using only up to three fractional digits. Caso contrário, ele simplesmente chama x o método Equals do parâmetro.Otherwise, it simply calls the x parameter's Equals method. O exemplo usa essa IEqualityComparer implementação para determinar se quatro Tuple<T1,T2,T3,T4,T5,T6> objetos que contêm dados sobre a taxa de alteração de população entre 1960 e 2000 são iguais.The example uses this IEqualityComparer implementation to determine whether four Tuple<T1,T2,T3,T4,T5,T6> objects that contain data on the rate of population change between 1960 and 2000 are equal.

using System;
using System.Collections;

public class RateComparer<T1, T2, T3, T4, T5, T6> : IEqualityComparer
{
   private int argument = 0;

   public new bool Equals(object x, object y) 
   {
      argument++;
      if (argument == 1) return true;

      double fx, fy; 
      if (x is Double || x is Single)
      {
            fx = (double) x;
            fy = (double) y;
            return Math.Round(fx * 1000).Equals(Math.Round(fy * 1000));
      }
      else
      {
         return x.Equals(y);
      }
   }
   
   public int GetHashCode(object obj)
   {
      if (obj is Single || obj is Double)
         return Math.Round(((double) obj) * 1000).GetHashCode();
      else
         return obj.GetHashCode();
   }                
}

public class Example
{
   public static void Main()
   {
      var rate1 = Tuple.Create("New York", .014505, -.1042733, 
                               .0354833, .093644, .0290792);
      var rate2 = Tuple.Create("Unknown City", .014505, -.1042733, 
                               .0354833, .093644, .0290792);
      var rate3 = Tuple.Create("Unknown City", .014505, -.1042733, 
                               .0354833, .093644, .029079);
      var rate4 = Tuple.Create("San Francisco", -.0332858, -.0512803, 
                               .0662544, .0728964, .0491912);
      IStructuralEquatable eq = rate1;
      // Compare first tuple with remaining two tuples.
      Console.WriteLine("{0} = ", rate1.ToString());
      Console.WriteLine("   {0} : {1}", rate2, 
                        eq.Equals(rate2, new RateComparer<string, double, double, double, double, double>()));
      Console.WriteLine("   {0} : {1}", rate3, 
                        eq.Equals(rate3, new RateComparer<string, double, double, double, double, double>()));
      Console.WriteLine("   {0} : {1}", rate4, 
                        eq.Equals(rate4, new RateComparer<string, double, double, double, double, double>()));
   }
}
// The example displays the following output:
//    (New York, 0.014505, -0.1042733, 0.0354833, 0.093644, 0.0290792) =
//       (Unknown City, 0.014505, -0.1042733, 0.0354833, 0.093644, 0.0290792) : True
//       (Unknown City, 0.014505, -0.1042733, 0.0354833, 0.093644, 0.029079) : True
//       (San Francisco, -0.0332858, -0.0512803, 0.0662544, 0.0728964, 0.0491912) : False
Imports System.Collections

Public Class RateComparer(Of T1, T2, T3, T4, T5, T6) : Implements IEqualityComparer
   Private argument As Integer = 0

   Public Overloads Function Equals(x As Object, y As Object) As Boolean _
                   Implements IEqualityComparer.Equals
      argument += 1
      If argument = 1 Then
         Return True
      Else
         Dim fx, fy As Double
         If typeof x Is Double Or typeof x Is Single Then
            fx = CDbl(x)
            fy = CDbl(y)
            Return Math.Round(fx * 1000).Equals(Math.Round(fy * 1000))
         Else
            Return x.Equals(y)
         End If
      End If   
   End Function
   
   Public Overloads Function GetHashCode(obj As Object) As Integer _
                    Implements IEqualityComparer.GetHashCode
      If TypeOf(obj) Is Single Or TypeOf(obj) Is Double Then
         Return Math.Round(CDbl(obj) * 1000).GetHashCode()
      Else
         Return obj.GetHashCode()
      End If
   End Function                
End Class

Module Example
   Public Sub Main()
      Dim rate1 = Tuple.Create("New York", .014505, -.1042733, 
                               .0354833, .093644, .0290792)
      Dim rate2 = Tuple.Create("Unknown City", .014505, -.1042733, 
                               .0354833, .093644, .0290792)
      Dim rate3 = Tuple.Create("Unknown City", .014505, -.1042733, 
                               .0354833, .093644, .029079)
      Dim rate4 = Tuple.Create("San Francisco", -.0332858, -.0512803, 
                               .0662544, .0728964, .0491912)
      Dim eq As IStructuralEquatable = rate1
      ' Compare first tuple with remaining two tuples.
      Console.WriteLine("{0} = ", rate1.ToString())
      Console.WriteLine("   {0} : {1}", rate2, 
                        eq.Equals(rate2, New RateComparer(Of String, Double, Double, Double, Double, Double)()))
      Console.WriteLine("   {0} : {1}", rate3, 
                        eq.Equals(rate3, New RateComparer(Of String, Double, Double, Double, Double, Double)()))
      Console.WriteLine("   {0} : {1}", rate4, 
                        eq.Equals(rate4, New RateComparer(Of String, Double, Double, Double, Double, Double)()))
   End Sub
End Module
' The example displays the following output:
'    (New York, 0.014505, -0.1042733, 0.0354833, 0.093644, 0.0290792) =
'       (Unknown City, 0.014505, -0.1042733, 0.0354833, 0.093644, 0.0290792) : True
'       (Unknown City, 0.014505, -0.1042733, 0.0354833, 0.093644, 0.029079) : True
'       (San Francisco, -0.0332858, -0.0512803, 0.0662544, 0.0728964, 0.0491912) : False

Comentários

Este membro é uma implementação do membro de interface explícita.This member is an explicit interface member implementation. Ele só pode ser usado quando a instância de Tuple<T1,T2,T3,T4,T5,T6> é convertida em uma interface de IStructuralEquatable.It can be used only when the Tuple<T1,T2,T3,T4,T5,T6> instance is cast to an IStructuralEquatable interface.

A IEqualityComparer.Equals implementação é chamada somente se other não nullfor, e se ela puder ser convertida com êxito ( C#in) ou convertido (em Visual Basic) em Tuple<T1,T2,T3,T4,T5,T6> um objeto cujos componentes são dos mesmos tipos que a instância atual.The IEqualityComparer.Equals implementation is called only if other is not null, and if it can be successfully cast (in C#) or converted (in Visual Basic) to a Tuple<T1,T2,T3,T4,T5,T6> object whose components are of the same types as the current instance. O IStructuralEquatable.Equals(Object, IEqualityComparer) método primeiro passa os Item1 valores dos Tuple<T1,T2,T3,T4,T5,T6> objetos para serem comparados com IEqualityComparer.Equals a implementação.The IStructuralEquatable.Equals(Object, IEqualityComparer) method first passes the Item1 values of the Tuple<T1,T2,T3,T4,T5,T6> objects to be compared to the IEqualityComparer.Equals implementation. Se essa chamada de método trueretornar, o método será chamado novamente e passará os Item2 valores dos Tuple<T1,T2,T3,T4,T5,T6> dois objetos.If this method call returns true, the method is called again and passed the Item2 values of the two Tuple<T1,T2,T3,T4,T5,T6> objects. Isso continuará até que a chamada false de método seja retornada ao comparar um Item par de valores específico ou Item6 que os dois valores sejam passados para o método.This continues until the method call returns false when it compares a specific pair of Item values, or the two Item6 values are passed to the method.

Aplica-se a