Enumerable.FirstOrDefault Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.dll

Devuelve el primer elemento de una secuencia o un valor predeterminado si no se encuentra ningún elemento.

Sobrecargas

FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)	Devuelve el primer elemento de la secuencia que satisface una condición o un valor predeterminado especificado si no se encuentra ningún elemento de este tipo.
FirstOrDefault<TSource>(IEnumerable<TSource>, TSource)	Devuelve el primer elemento de una secuencia o un valor predeterminado especificado si la secuencia no contiene ningún elemento.
FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Devuelve el primer elemento de la secuencia que satisface una condición o un valor predeterminado si no se encuentra dicho elemento.
FirstOrDefault<TSource>(IEnumerable<TSource>)	Devuelve el primer elemento de una secuencia o un valor predeterminado si la secuencia no contiene elementos.

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

Source:

First.cs

Devuelve el primer elemento de la secuencia que satisface una condición o un valor predeterminado especificado si no se encuentra ningún elemento de este tipo.

C#

public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate, TSource defaultValue);

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.

defaultValue

TSource

Valor predeterminado que se va a devolver si la secuencia está vacía.

Devoluciones

TSource

defaultValue si source está vacío o si ningún elemento supera la prueba especificada por predicate; de lo contrario, el primer elemento de source que pasa la prueba especificada por predicate.

Excepciones

ArgumentNullException

source o predicate es null.

FirstOrDefault<TSource>(IEnumerable<TSource>, TSource)

Source:

First.cs

Devuelve el primer elemento de una secuencia o un valor predeterminado especificado si la secuencia no contiene ningún elemento.

C#

public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource defaultValue);

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.

defaultValue

TSource

Valor predeterminado que se va a devolver si la secuencia está vacía.

Devoluciones

TSource

defaultValue es si source está vacío; de lo contrario, el primer elemento de source.

Excepciones

ArgumentNullException

source es null.

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

Source:

First.cs

Devuelve el primer elemento de la secuencia que satisface una condición o un valor predeterminado si no se encuentra dicho elemento.

C#

public static TSource? FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

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

default (TSource) si source está vacío o si ningún elemento pasa la prueba especificada en predicate; de lo contrario, el primer elemento de source que pasa la prueba especificada en predicate.

Excepciones

ArgumentNullException

source o predicate es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) pasando un predicado. En la segunda llamada al método , no hay ningún elemento en la matriz que cumpla la condición.

C#

string[] names = { "Hartono, Tommy", "Adams, Terry",
                     "Andersen, Henriette Thaulow",
                     "Hedlund, Magnus", "Ito, Shu" };

string firstLongName = names.FirstOrDefault(name => name.Length > 20);

Console.WriteLine("The first long name is '{0}'.", firstLongName);

string firstVeryLongName = names.FirstOrDefault(name => name.Length > 30);

Console.WriteLine(
    "There is {0} name longer than 30 characters.",
    string.IsNullOrEmpty(firstVeryLongName) ? "not a" : "a");

/*
 This code produces the following output:

 The first long name is 'Andersen, Henriette Thaulow'.
 There is not a name longer than 30 characters.
*/

Comentarios

El valor predeterminado para los tipos de referencia y que aceptan valores NULL es null.

FirstOrDefault<TSource>(IEnumerable<TSource>)

Source:

First.cs

Devuelve el primer elemento de una secuencia o un valor predeterminado si la secuencia no contiene elementos.

C#

public static TSource? FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

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

default (TSource) si source está vacío; de lo contrario, el primer elemento de source.

Excepciones

ArgumentNullException

source es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar FirstOrDefault<TSource>(IEnumerable<TSource>) en una matriz vacía.

C#

int[] numbers = { };
int first = numbers.FirstOrDefault();
Console.WriteLine(first);

/*
 This code produces the following output:

 0
*/

A veces, el valor de default(TSource) no es el valor predeterminado que desea usar si la colección no contiene ningún elemento. En lugar de comprobar el resultado del valor predeterminado no deseado y, a continuación, cambiarlo si es necesario, puede usar el DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) método para especificar el valor predeterminado que desea usar si la colección está vacía. A continuación, llame First<TSource>(IEnumerable<TSource>) a para obtener el primer elemento. En el ejemplo de código siguiente se usan ambas técnicas para obtener un valor predeterminado de 1 si una colección de meses numéricos está vacía. Dado que el valor predeterminado de un entero es 0, que no corresponde a ningún mes, el valor predeterminado debe especificarse como 1 en su lugar. La primera variable de resultado se comprueba para el valor predeterminado no deseado después de que la consulta haya terminado de ejecutarse. La segunda variable de resultado se obtiene mediante DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) para especificar un valor predeterminado de 1.

C#

List<int> months = new List<int> { };

// Setting the default value to 1 after the query.
int firstMonth1 = months.FirstOrDefault();
if (firstMonth1 == 0)
{
    firstMonth1 = 1;
}
Console.WriteLine("The value of the firstMonth1 variable is {0}", firstMonth1);

// Setting the default value to 1 by using DefaultIfEmpty() in the query.
int firstMonth2 = months.DefaultIfEmpty(1).First();
Console.WriteLine("The value of the firstMonth2 variable is {0}", firstMonth2);

/*
 This code produces the following output:

 The value of the firstMonth1 variable is 1
 The value of the firstMonth2 variable is 1
*/

Comentarios

El valor predeterminado para los tipos de referencia y que aceptan valores NULL es null.

El FirstOrDefault método no proporciona una manera de especificar un valor predeterminado. Si desea especificar un valor predeterminado distinto default(TSource)de , use el DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) método como se describe en la sección Ejemplo.