Enumerable.First Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.dll

Devuelve el primer elemento de una secuencia.

Sobrecargas

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>)

Source:

First.cs

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>

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

Devoluciones

TSource

El 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 ningún elemento. Para devolver un valor predeterminado cuando la secuencia de origen está vacía, use el FirstOrDefault método .

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

Source:

First.cs

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>

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

predicate

Func<TSource,Boolean>

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

Devoluciones

TSource

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

Excepciones

ArgumentNullException

source o predicate es null.

InvalidOperationException

Ningún elemento satisface la condición de 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 cumpla 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 .