Enumerable.First<TSource> Method (IEnumerable<TSource>, Func<TSource, Boolean>)

Returns the first element in a sequence that satisfies a specified condition.

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

public static TSource First<TSource>(
	this IEnumerable<TSource> source,
	Func<TSource, bool> predicate
)

Type Parameters

TSource

The type of the elements of source.

Parameters

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

An IEnumerable<T> to return an element from.

predicate
Type: System.Func<TSource, Boolean>

A function to test each element for a condition.

Return Value

Type: TSource
The first element in the sequence that passes the test in the specified predicate function.

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

source or predicate is null.

InvalidOperationException

No element satisfies the condition in predicate.

-or-

The source sequence is empty.

The First<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) method throws an exception if no matching element is found in source. To instead return a default value when no matching element is found, use the FirstOrDefault method.

The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) to return the first element of an array that satisfies a condition.

            int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54, 
                                83, 23, 87, 435, 67, 12, 19 };

            int first = numbers.First(number => number > 80);

            Console.WriteLine(first);

            /*
             This code produces the following output:

             92
            */

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft