Enumerable.First Método

Definición

Espacio de nombres:
System.Linq
Ensamblados:
System.Core.dll, System.Linq.dll
Ensamblado:
System.Core.dll
Ensamblado:
System.Linq.dll
Ensamblado:
netstandard.dll

Devuelve el primer elemento de una secuencia.

Sobrecargas

Nombre Description
First<TSource>(IEnumerable<TSource>)

Devuelve el primer elemento de una secuencia.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

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

First<TSource>(IEnumerable<TSource>)

Devuelve el primer elemento de una secuencia.

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.

Parámetros

source
IEnumerable<TSource>

que IEnumerable<T> se va a devolver el primer elemento de .

Devoluciones

TSource

Primer elemento de la secuencia especificada.

Excepciones

ArgumentNullException

source es null.

InvalidOperationException

La secuencia de origen está vacía.

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.

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.
Console.WriteLine(first)

' This code produces the following output:
'
' 9

Comentarios

El First<TSource>(IEnumerable<TSource>) método produce una excepción si source no contiene elementos. Para devolver un valor predeterminado cuando la secuencia de origen está vacía, use el FirstOrDefault método .

Se aplica a

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

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

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.

Parámetros

source
IEnumerable<TSource>

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

predicate
Func<TSource,Boolean>

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

Devoluciones

TSource

Primer elemento de la secuencia que pasa la prueba en la función de predicado especificada.

Excepciones

ArgumentNullException

source o predicate es null.

InvalidOperationException

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

O bien

La secuencia de origen está vacía.

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.

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.
Console.WriteLine(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. Para devolver un valor predeterminado cuando no se encuentra ningún elemento coincidente, use el FirstOrDefault método .

Se aplica a