IStructuralEquatable.Equals(Object, IEqualityComparer) 方法

定义

命名空间:

System.Collections

程序集:

System.Runtime.dll

确定某个对象与当前实例在结构上是否相等。

public:
 bool Equals(System::Object ^ other, System::Collections::IEqualityComparer ^ comparer);

public bool Equals (object? other, System.Collections.IEqualityComparer comparer);

abstract member Equals : obj * System.Collections.IEqualityComparer -> bool

Public Function Equals (other As Object, comparer As IEqualityComparer) As Boolean

参数

other

Object

要与当前实例进行比较的对象。

comparer

IEqualityComparer

一个对象，用于确定当前实例和 other 是否相等。

返回

Boolean

如果两个对象相等，则为 true；否则为 false。

示例

默认相等比较器 EqualityComparer<Object>.Default.Equals认为两个 NaN 值相等。 但是，在某些情况下，你可能希望相等值的 NaN 比较返回 false，这表示无法比较这些值。 下面的示例定义一个实现 NanComparer 接口的 IStructuralEquatable 类。 它使用相等运算符比较两 Double 个或两个 Single 值。 它将任何其他类型的值传递到默认相等比较器。

using System;
using System.Collections;
using System.Collections.Generic;

public class NanComparer : IEqualityComparer
{
   public new bool Equals(object x, object y)
   {
      if (x is float)
         return (float) x == (float) y;
      else if (x is double)
         return (double) x == (double) y;
      else
         return EqualityComparer<object>.Default.Equals(x, y);
   }

   public int GetHashCode(object obj)
   {
      return EqualityComparer<object>.Default.GetHashCode(obj);
   }
}

Imports System.Collections
Imports System.Collections.Generic

Public Class NanComparer : Implements IEqualityComparer
   Public Overloads Function Equals(x As Object, y As Object) As Boolean _
          Implements IEqualityComparer.Equals
      If TypeOf x Is Single Then
         Return CSng(x) = CSng(y)
      ElseIf TypeOf x Is Double Then
         Return CDbl(x) = CDbl(y)
      Else
         Return EqualityComparer(Of Object).Default.Equals(x, y)
      End If
   End Function
   
   Public Overloads Function GetHashCode(obj As Object) As Integer _
          Implements IEqualityComparer.GetHashCode
      Return EqualityComparer(Of Object).Default.GetHashCode(obj)
   End Function
End Class

以下示例创建两个相同的 3 元组对象，其组件由三 Double 个值组成。 第二个组件的 Double.NaN值为 。 然后，该示例调用 Tuple<T1,T2,T3>.Equals 方法，并调用该方法 IStructuralEquatable.Equals 三次。 第一次，它传递由 EqualityComparer<T>.Default 属性返回的默认相等比较器。 第二次传递由 属性返回 StructuralComparisons.StructuralEqualityComparer 的默认相等比较器。 第三次传递自定义 NanComparer 对象。 如示例输出所示，前三个方法调用返回 true，而第四个调用返回 false。

public class Example
{
   public static void Main()
   {
      var t1 = Tuple.Create(12.3, Double.NaN, 16.4);
      var t2 = Tuple.Create(12.3, Double.NaN, 16.4);

      // Call default Equals method.
      Console.WriteLine(t1.Equals(t2));

      IStructuralEquatable equ = t1;
      // Call IStructuralEquatable.Equals using default comparer.
      Console.WriteLine(equ.Equals(t2, EqualityComparer<object>.Default));

      // Call IStructuralEquatable.Equals using
      // StructuralComparisons.StructuralEqualityComparer.
      Console.WriteLine(equ.Equals(t2,
                        StructuralComparisons.StructuralEqualityComparer));

      // Call IStructuralEquatable.Equals using custom comparer.
      Console.WriteLine(equ.Equals(t2, new NanComparer()));
   }
}
// The example displays the following output:
//       True
//       True
//       True
//       False

Module Example
   Public Sub Main()
      Dim t1 = Tuple.Create(12.3, Double.NaN, 16.4)
      Dim t2 = Tuple.Create(12.3, Double.NaN, 16.4)
      
      ' Call default Equals method.
      Console.WriteLine(t1.Equals(t2))
      
      Dim equ As IStructuralEquatable = t1
      ' Call IStructuralEquatable.Equals using default comparer.
      Console.WriteLine(equ.Equals(t2, EqualityComparer(Of Object).Default))
      
      ' Call IStructuralEquatable.Equals using 
      ' StructuralComparisons.StructuralEqualityComparer.
      Console.WriteLine(equ.Equals(t2, 
                        StructuralComparisons.StructuralEqualityComparer))
      
      ' Call IStructuralEquatable.Equals using custom comparer.
      Console.WriteLine(equ.Equals(t2, New NanComparer))
   End Sub
End Module
' The example displays the following output:
'       True
'       True
'       True
'       False

注解

方法 Equals 支持数组和元组对象的自定义结构比较。 此方法又调用 comparer 对象的 IEqualityComparer.Equals 方法，以比较单个数组元素或元组组件（从第一个元素或组件开始）。 当方法调用 IEqualityComparer.Equals 返回或比较所有数组元素或元组组件后，对 end IStructuralEquatable.Equals 和 方法的单独调用将返回 false 一个值。

另请参阅

• StructuralEqualityComparer