Enumerable.First Enumerable.First Enumerable.First Enumerable.First Method

Definición

Devuelve el primer elemento de una secuencia.Returns the first element of a sequence.

Sobrecargas

First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>)

Devuelve el primer elemento de una secuencia.Returns the first element of a sequence.

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Devuelve el primer elemento de una secuencia que satisface una condición especificada.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>)

Devuelve el primer elemento de una secuencia.Returns the first element of a sequence.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Collections::Generic::IEnumerable<TSource> ^ source);
public static TSource First<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);
static member First : seq<'Source> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IEnumerable(Of TSource)) As TSource

Parámetros de tipo

TSource

Tipo de los elementos de source.The type of the elements of source.

Parámetros

source
IEnumerable<TSource>

IEnumerable<T> del que se va a devolver el primer elemento.The IEnumerable<T> to return the first element of.

Devoluciones

TSource TSource TSource TSource

El primer elemento de la secuencia especificada.The first element in the specified sequence.

Excepciones

La secuencia de origen está vacía.The source sequence is empty.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar First<TSource>(IEnumerable<TSource>) para devolver el primer elemento de una matriz.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>) to return the first element of an array.

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

int first = numbers.First();

Console.WriteLine(first);

/*
 This code produces the following output:

 9
*/
' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array.
Dim first As Integer = numbers.First()

' Display the output.
MsgBox(first)

' This code produces the following output:
'
' 9

Comentarios

El First<TSource>(IEnumerable<TSource>) método produce una excepción si source no contiene ningún elemento.The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Para devolver en su lugar un valor predeterminado cuando la secuencia de origen está vacía, use la FirstOrDefault método.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Devuelve el primer elemento de una secuencia que satisface una condición especificada.Returns the first element in a sequence that satisfies a specified condition.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);
public static TSource First<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);
static member First : seq<'Source> * Func<'Source, bool> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As TSource

Parámetros de tipo

TSource

Tipo de los elementos de source.The type of the elements of source.

Parámetros

source
IEnumerable<TSource>

IEnumerable<T> del que se va a devolver un elemento.An IEnumerable<T> to return an element from.

predicate
Func<TSource,Boolean>

Función para probar cada elemento de una condición.A function to test each element for a condition.

Devoluciones

TSource TSource TSource TSource

El primer elemento de la secuencia que pasa la prueba de la función de predicado especificada.The first element in the sequence that passes the test in the specified predicate function.

Excepciones

source o predicate es null.source or predicate is null.

Ningún elemento satisface la condición de predicate.No element satisfies the condition in predicate.

O bien-or- La secuencia de origen está vacía.The source sequence is empty.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) para devolver el primer elemento de una matriz que satisface una condición.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
*/
' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array whose value is greater than 80.
Dim first As Integer = numbers.First(Function(number) number > 80)

' Display the output.
MsgBox(first)

' This code produces the following output:
'
' 92

Comentarios

El First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) método produce una excepción si no se encuentra ningún elemento coincidente en source.The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Para devolver en su lugar un valor predeterminado cuando no se encuentra ningún elemento coincidente, use el FirstOrDefault método.To instead return a default value when no matching element is found, use the FirstOrDefault method.

Se aplica a