Enumerable.SequenceEqual(TSource) Method (IEnumerable(TSource), IEnumerable(TSource), IEqualityComparer(TSource))

Determines whether two sequences are equal by comparing their elements by using a specified IEqualityComparer(T).

Namespace:  System.Linq
Assembly:  System.Core (in System.Core.dll)

static member SequenceEqual : 
        first:IEnumerable<'TSource> * 
        second:IEnumerable<'TSource> * 
        comparer:IEqualityComparer<'TSource> -> bool 

Type Parameters

TSource

The type of the elements of the input sequences.

Parameters

first
Type: System.Collections.Generic.IEnumerable(TSource)
An IEnumerable(T) to compare to second.
second
Type: System.Collections.Generic.IEnumerable(TSource)
An IEnumerable(T) to compare to the first sequence.
comparer
Type: System.Collections.Generic.IEqualityComparer(TSource)
An IEqualityComparer(T) to use to compare elements.

Return Value

Type: System.Boolean
true if the two source sequences are of equal length and their corresponding elements compare equal according to comparer; otherwise, false.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type IEnumerable(TSource). When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

ExceptionCondition
ArgumentNullException

first or second is a null reference (Nothing in Visual Basic).

The SequenceEqual(TSource)(IEnumerable(TSource), IEnumerable(TSource), IEqualityComparer(TSource)) method enumerates the two source sequences in parallel and compares corresponding elements by using the specified IEqualityComparer(T). If comparer is a null reference (Nothing in Visual Basic), the default equality comparer, Default, is used to compare elements.

The following example shows how to implement an equality comparer that can be used in the SequenceEqual(TSource)(IEnumerable(TSource), IEnumerable(TSource), IEqualityComparer(TSource)) method.

No code example is currently available or this language may not be supported.

After you implement this comparer, you can use sequences of Product objects in the SequenceEqual(TSource)(IEnumerable(TSource), IEnumerable(TSource), IEqualityComparer(TSource)) method, as shown in the following example.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft