IEquatable<T> Interfejs

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Definiuje uogólnioną metodę implementowaną przez typ wartości lub klasę w celu utworzenia metody specyficznej dla typu w celu określenia równości wystąpień.

C#

public interface IEquatable<T>

Parametry typu

T

Typ obiektów do porównania.

Pochodne

Microsoft.Extensions.AsyncState.AsyncStateToken

Microsoft.Extensions.Compliance.Classification.DataClassification

Microsoft.Extensions.Compliance.Classification.DataClassificationSet

Microsoft.Extensions.Compliance.Testing.RedactedData

Microsoft.Extensions.Compliance.Testing.RedactorRequested

Microsoft.Extensions.DependencyModel.Dependency

Microsoft.Extensions.Diagnostics.ExceptionSummarization.ExceptionSummary

Microsoft.Extensions.Diagnostics.Latency.Checkpoint

Microsoft.Extensions.Diagnostics.Latency.Measure

Microsoft.Extensions.FileSystemGlobbing.FilePatternMatch

Microsoft.Extensions.Logging.EventId

Microsoft.Extensions.Primitives.StringSegment

Microsoft.Extensions.Primitives.StringValues

Microsoft.VisualBasic.Activities.VisualBasicImportReference

System.Activities.Bookmark

System.Activities.BookmarkScope

System.Activities.WorkflowIdentity

System.Boolean

System.Buffers.NIndex

System.Buffers.NRange

System.Buffers.StandardFormat

System.Byte

System.Char

System.Collections.Immutable.ImmutableArray<T>

System.Collections.Specialized.BitVector32

System.Collections.Specialized.BitVector32.Section

System.CommandLine.ArgumentArity

System.CommandLine.Help.TwoColumnHelpRow

System.CommandLine.Parsing.Token

System.ComponentModel.Composition.ReflectionModel.LazyMemberInfo

System.ComponentModel.Design.Serialization.MemberRelationship

System.ConsoleKeyInfo

System.Data.EntityKey

System.Data.Linq.Binary

System.Data.SqlTypes.SqlBinary

System.Data.SqlTypes.SqlBoolean

System.Data.SqlTypes.SqlByte

System.Data.SqlTypes.SqlDateTime

System.Data.SqlTypes.SqlDecimal

System.Data.SqlTypes.SqlDouble

System.Data.SqlTypes.SqlGuid

System.Data.SqlTypes.SqlInt16

System.Data.SqlTypes.SqlInt32

System.Data.SqlTypes.SqlInt64

System.Data.SqlTypes.SqlMoney

System.Data.SqlTypes.SqlSingle

System.Data.SqlTypes.SqlString

System.DateOnly

System.DateTime

System.DateTimeOffset

System.Decimal

System.Device.Location.GeoCoordinate

System.Diagnostics.ActivityContext

System.Diagnostics.ActivityLink

System.Diagnostics.ActivitySpanId

System.Diagnostics.ActivityTraceId

System.Diagnostics.CounterSample

System.Diagnostics.SymbolStore.SymbolToken

System.Double

System.Drawing.CharacterRange

System.Drawing.Color

System.Drawing.Point

System.Drawing.PointF

System.Drawing.Rectangle

System.Drawing.RectangleF

System.Drawing.Size

System.Drawing.SizeF

System.Formats.Asn1.Asn1Tag

System.Formats.Nrbf.SerializationRecordId

System.Globalization.SortVersion

System.Guid

System.Half

System.Index

System.Int128

System.Int16

System.Int32

System.Int64

System.IntPtr

System.Memory<T>

System.ModuleHandle

System.Net.Http.HttpMethod

System.Net.IPNetwork

System.Net.PeerToPeer.Cloud

System.Net.PeerToPeer.Collaboration.Peer

System.Net.PeerToPeer.Collaboration.PeerApplication

System.Net.PeerToPeer.Collaboration.PeerContact

System.Net.PeerToPeer.Collaboration.PeerEndPoint

System.Net.PeerToPeer.Collaboration.PeerEndPointCollection

System.Net.PeerToPeer.Collaboration.PeerNearMe

System.Net.PeerToPeer.Collaboration.PeerObject

System.Net.PeerToPeer.PeerName

System.Net.Security.SslApplicationProtocol

System.Net.SocketAddress

System.Net.Sockets.IPPacketInformation

System.Net.Sockets.UdpReceiveResult

System.Numerics.BigInteger

System.Numerics.Complex

System.Numerics.IBinaryFloatingPointIeee754<TSelf>

System.Numerics.IBinaryInteger<TSelf>

System.Numerics.IBinaryNumber<TSelf>

System.Numerics.IExponentialFunctions<TSelf>

System.Numerics.IFloatingPoint<TSelf>

System.Numerics.IFloatingPointConstants<TSelf>

System.Numerics.IFloatingPointIeee754<TSelf>

System.Numerics.IHyperbolicFunctions<TSelf>

System.Numerics.ILogarithmicFunctions<TSelf>

System.Numerics.INumber<TSelf>

System.Numerics.INumberBase<TSelf>

System.Numerics.IPowerFunctions<TSelf>

System.Numerics.IRootFunctions<TSelf>

System.Numerics.ISignedNumber<TSelf>

System.Numerics.ITrigonometricFunctions<TSelf>

System.Numerics.IUnsignedNumber<TSelf>

System.Numerics.Matrix3x2

System.Numerics.Matrix4x4

System.Numerics.Plane

System.Numerics.Quaternion

System.Numerics.TotalOrderIeee754Comparer<T>

System.Numerics.Vector<T>

System.Numerics.Vector2

System.Numerics.Vector3

System.Numerics.Vector4

System.Range

System.ReadOnlyMemory<T>

System.Reflection.CustomAttributeNamedArgument

System.Reflection.CustomAttributeTypedArgument

System.Reflection.Emit.ExceptionHandler

System.Reflection.Emit.Label

System.Reflection.Emit.OpCode

System.Reflection.Metadata.AssemblyDefinitionHandle

System.Reflection.Metadata.AssemblyFileHandle

System.Reflection.Metadata.AssemblyReferenceHandle

System.Reflection.Metadata.BlobContentId

System.Reflection.Metadata.BlobHandle

System.Reflection.Metadata.ConstantHandle

System.Reflection.Metadata.CustomAttributeHandle

System.Reflection.Metadata.CustomDebugInformationHandle

System.Reflection.Metadata.DeclarativeSecurityAttributeHandle

System.Reflection.Metadata.DocumentHandle

System.Reflection.Metadata.DocumentNameBlobHandle

System.Reflection.Metadata.Ecma335.EditAndContinueLogEntry

System.Reflection.Metadata.Ecma335.LabelHandle

System.Reflection.Metadata.EntityHandle

System.Reflection.Metadata.EventDefinitionHandle

System.Reflection.Metadata.ExportedTypeHandle

System.Reflection.Metadata.FieldDefinitionHandle

System.Reflection.Metadata.GenericParameterConstraintHandle

System.Reflection.Metadata.GenericParameterHandle

System.Reflection.Metadata.GuidHandle

System.Reflection.Metadata.Handle

System.Reflection.Metadata.ImportScopeHandle

System.Reflection.Metadata.InterfaceImplementationHandle

System.Reflection.Metadata.LocalConstantHandle

System.Reflection.Metadata.LocalScopeHandle

System.Reflection.Metadata.LocalVariableHandle

System.Reflection.Metadata.ManifestResourceHandle

System.Reflection.Metadata.MemberReferenceHandle

System.Reflection.Metadata.MethodDebugInformationHandle

System.Reflection.Metadata.MethodDefinitionHandle

System.Reflection.Metadata.MethodImplementationHandle

System.Reflection.Metadata.MethodSpecificationHandle

System.Reflection.Metadata.ModuleDefinitionHandle

System.Reflection.Metadata.ModuleReferenceHandle

System.Reflection.Metadata.NamespaceDefinitionHandle

System.Reflection.Metadata.ParameterHandle

System.Reflection.Metadata.PropertyDefinitionHandle

System.Reflection.Metadata.SequencePoint

System.Reflection.Metadata.SignatureHeader

System.Reflection.Metadata.StandaloneSignatureHandle

System.Reflection.Metadata.StringHandle

System.Reflection.Metadata.TypeDefinitionHandle

System.Reflection.Metadata.TypeReferenceHandle

System.Reflection.Metadata.TypeSpecificationHandle

System.Reflection.Metadata.UserStringHandle

System.Runtime.DurableInstancing.InstancePersistenceEvent

System.Runtime.InteropServices.ArrayWithOffset

System.Runtime.InteropServices.CLong

System.Runtime.InteropServices.CULong

System.Runtime.InteropServices.GCHandle

System.Runtime.InteropServices.NFloat

System.Runtime.InteropServices.OSPlatform

System.Runtime.Intrinsics.Vector128<T>

System.Runtime.Intrinsics.Vector256<T>

System.Runtime.Intrinsics.Vector512<T>

System.Runtime.Intrinsics.Vector64<T>

System.Runtime.Versioning.FrameworkName

System.RuntimeFieldHandle

System.RuntimeMethodHandle

System.RuntimeTypeHandle

System.SByte

System.Security.Cryptography.CngAlgorithm

System.Security.Cryptography.CngAlgorithmGroup

System.Security.Cryptography.CngKeyBlobFormat

System.Security.Cryptography.CngProperty

System.Security.Cryptography.CngProvider

System.Security.Cryptography.Cose.CoseHeaderLabel

System.Security.Cryptography.Cose.CoseHeaderValue

System.Security.Cryptography.HashAlgorithmName

System.Security.Cryptography.RSAEncryptionPadding

System.Security.Cryptography.RSASignaturePadding

System.SequencePosition

System.ServiceModel.Channels.HttpMessageSettings

System.ServiceModel.Channels.WebSocketTransportSettings

System.ServiceModel.Discovery.DiscoveryMessageSequence

System.ServiceProcess.SessionChangeDescription

System.Single

System.Speech.Synthesis.TtsEngine.ContourPoint

System.Speech.Synthesis.TtsEngine.FragmentState

System.Speech.Synthesis.TtsEngine.ProsodyNumber

System.Speech.Synthesis.TtsEngine.SpeechEventInfo

System.String

System.Text.Json.JsonEncodedText

System.Text.Rune

System.Threading.AsyncFlowControl

System.Threading.CancellationToken

System.Threading.CancellationTokenRegistration

System.Threading.LockCookie

System.Threading.Tasks.Dataflow.DataflowMessageHeader

System.Threading.Tasks.ValueTask

System.Threading.Tasks.ValueTask<TResult>

System.TimeOnly

System.TimeSpan

System.TimeZoneInfo

System.TimeZoneInfo.AdjustmentRule

System.TimeZoneInfo.TransitionTime

System.Transactions.TransactionOptions

System.UInt128

System.UInt16

System.UInt32

System.UInt64

System.UIntPtr

System.ValueTuple

System.ValueTuple<T1>

System.ValueTuple<T1,T2>

System.ValueTuple<T1,T2,T3>

System.ValueTuple<T1,T2,T3,T4>

System.ValueTuple<T1,T2,T3,T4,T5>

System.ValueTuple<T1,T2,T3,T4,T5,T6>

System.ValueTuple<T1,T2,T3,T4,T5,T6,T7>

System.ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>

System.Version

System.Windows.Controls.DataGridLength

System.Windows.Controls.Ribbon.RibbonControlLength

System.Windows.Controls.VirtualizationCacheLength

System.Windows.CornerRadius

System.Windows.FigureLength

System.Windows.GridLength

System.Windows.Input.StylusPoint

System.Windows.Input.TouchPoint

System.Windows.Media.Animation.KeyTime

System.Windows.Media.Color

System.Windows.Media.PixelFormat

System.Windows.Media.TextFormatting.CharacterBufferRange

System.Windows.Media.TextFormatting.CharacterBufferReference

System.Windows.Media.TextFormatting.CharacterHit

System.Windows.Media.TextFormatting.MinMaxParagraphWidth

System.Windows.ThemeMode

System.Windows.Thickness

System.Xaml.AttachableMemberIdentifier

System.Xaml.Schema.XamlValueConverter<TConverterBase>

System.Xaml.XamlMember

System.Xaml.XamlType

System.Xml.Linq.XName

Przykłady

Zobacz przykład metody IEquatable<T>.Equals.

Uwagi

Ten interfejs jest implementowany przez typy, których wartości mogą być utożsamiane (na przykład klasy liczbowe i ciągowe). Typ wartości lub klasa implementuje metodę Equals, aby utworzyć metodę specyficzną dla typu odpowiednią do określania równości wystąpień.

Uwaga

Interfejs IComparable<T> definiuje metodę CompareTo, która określa kolejność sortowania wystąpień typu implementowania. Interfejs IEquatable<T> definiuje metodę Equals, która określa równość wystąpień typu implementowania.

Interfejs IEquatable<T> jest używany przez ogólne obiekty kolekcji, takie jak Dictionary<TKey,TValue>, List<T>i LinkedList<T> podczas testowania równości w takich metodach jak Contains, IndexOf, LastIndexOfi Remove. Należy go zaimplementować dla dowolnego obiektu, który może być przechowywany w kolekcji ogólnej.

Uwagi dotyczące implementowania

Zastąp parametr type interfejsu IEquatable<T> typem implementujący ten interfejs.

W przypadku implementacji IEquatable<T>należy również zastąpić implementacje klas bazowych Equals(Object) i GetHashCode(), aby ich zachowanie było zgodne z metodą Equals(T). Jeśli zastąpisz Equals(Object), implementacja zastąpienia jest również wywoływana w wywołaniach metody statycznej Equals(System.Object, System.Object) w klasie. Ponadto należy przeciążyć operatory op_Equality i op_Inequality. Gwarantuje to, że wszystkie testy równości zwracają spójne wyniki.

Aby uzyskać informacje na temat zastępowania Equals(Object), zobacz Equals(Object).

W przypadku typu wartości zawsze należy zaimplementować IEquatable<T> i zastąpić Equals(Object) w celu uzyskania lepszej wydajności. Equals(Object) typy wartości pól i opiera się na odbiciu, aby porównać dwie wartości pod kątem równości. Zarówno implementacja Equals(T), jak i zastąpienie Equals(Object) powinny zwracać spójne wyniki.

Jeśli zaimplementujesz IEquatable<T>, należy również zaimplementować IComparable<T>, jeśli wystąpienia typu mogą być uporządkowane lub sortowane. Jeśli typ implementuje IComparable<T>, prawie zawsze implementujesz również IEquatable<T>.

Należy pamiętać, że istnieją pewne projekty, w których typ obsługuje relację kolejności, ale równość może być różna od relacji porządkowania. Rozważ klasę Person, w której sortujesz alfabetycznie. Dwie osoby o tej samej nazwie posortują to samo, ale nie są tą samą osobą.

Metody

Equals(T)

Wskazuje, czy bieżący obiekt jest równy innemu obiektowi tego samego typu.

Dotyczy

Zobacz też

• IComparable<T>
• IComparable