Contains(TSource) Method (IEnumerable(TSource), TSource)
Collapse the table of content
Expand the table of content

Enumerable.Contains<TSource> Method (IEnumerable<TSource>, TSource)

 

Determines whether a sequence contains a specified element by using the default equality comparer.

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

public static bool Contains<TSource>(
	this IEnumerable<TSource> source,
	TSource value
)

Parameters

source
Type: System.Collections.Generic.IEnumerable<TSource>

A sequence in which to locate a value.

value
Type: TSource

The value to locate in the sequence.

Return Value

Type: System.Boolean

true if the source sequence contains an element that has the specified value; otherwise, false.

Type Parameters

TSource

The type of the elements of source.

Exception Condition
ArgumentNullException

source is null.

If the type of source implements ICollection<T>, the Contains method in that implementation is invoked to obtain the result. Otherwise, this method determines whether source contains the specified element.

Enumeration is terminated as soon as a matching element is found.

Elements are compared to the specified value by using the default equality comparer, Default.

The following code example demonstrates how to use Contains<TSource>(IEnumerable<TSource>, TSource) to determine whether an array contains a specific element.

string[] fruits = { "apple", "banana", "mango", "orange", "passionfruit", "grape" };

string fruit = "mango";

bool hasMango = fruits.Contains(fruit);

Console.WriteLine(
    "The array {0} contain '{1}'.",
    hasMango ? "does" : "does not",
    fruit);

// This code produces the following output:
//
// The array does contain 'mango'. 

Universal Windows Platform
Available since 8
.NET Framework
Available since 3.5
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show:
© 2016 Microsoft