First(TSource) Método (IEnumerable(TSource), Func(TSource, Boolean))
Collapse the table of content
Expand the table of content
Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Enumerable.First<TSource> (Método) (IEnumerable<TSource>, Func<TSource, Boolean>)

 

Devuelve el primer elemento de una secuencia que satisface una condición especificada.

Espacio de nombres:   System.Linq
Ensamblado:  System.Core (en System.Core.dll)

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

Parámetros

source

Interfaz IEnumerable<T> de la que se va a devolver un elemento.

predicate

Función para probar cada elemento de una condición.

Valor devuelto

Type: TSource

El primer elemento de la secuencia que pasa la prueba de la función de predicado especificada.

Parámetros de tipo

TSource

Tipo de los elementos de source.

Exception Condition
ArgumentNullException

source o predicate es null.

InvalidOperationException

Ningún elemento satisface la condición de predicate.

-o-

La secuencia de origen está vacía.

El método First<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) produce una excepción si no se encuentra ningún elemento que coincida en source.Para devolver en su lugar un valor predeterminado cuando no se encuentre ningún elemento que coincida, utilice el método FirstOrDefault<TSource>.

En el ejemplo de código siguiente se muestra cómo se utiliza First<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) para devolver el primer elemento de una matriz que cumple una condición.

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
*/

Universal Windows Platform
Disponible desde 4.5
.NET Framework
Disponible desde 3.5
Portable Class Library
Compatible con: portable .NET platforms
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar:
© 2016 Microsoft