Queryable.DefaultIfEmpty Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.Queryable.dll

Devuelve los elementos de una secuencia o una colección singleton con valores predeterminados si la secuencia está vacía.

Sobrecargas

DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource)	Devuelve los elementos de la secuencia especificada o el valor especificado en una colección singleton si la secuencia está vacía.
DefaultIfEmpty<TSource>(IQueryable<TSource>)	Devuelve los elementos de la secuencia especificada o el valor predeterminado del parámetro de tipo en una colección singleton si la secuencia está vacía.

DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource)

Source:

Queryable.cs

Devuelve los elementos de la secuencia especificada o el valor especificado en una colección singleton si la secuencia está vacía.

C#

public static System.Linq.IQueryable<TSource> DefaultIfEmpty<TSource> (this System.Linq.IQueryable<TSource> source, TSource defaultValue);

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IQueryable<TSource>

IQueryable<T> para el que se va a devolver el valor especificado si está vacío.

defaultValue

TSource

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

Devoluciones

IQueryable<TSource>

IQueryable<T> que contiene defaultValue si source está vacío; de lo contrario, source.

Excepciones

ArgumentNullException

source es null.

Ejemplos

En el ejemplo de código siguiente se muestra una situación en la que resulta útil llamar DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) a en una consulta LINQ. En este ejemplo se pasa un DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) valor predeterminado.

C#

// Create a list of Pet objects.
List<Pet> pets =
    new List<Pet>{ new Pet { Name="Barley", Age=8 },
                   new Pet { Name="Boots", Age=4 },
                   new Pet { Name="Whiskers", Age=1 } };

// This query selects only those pets that are 10 or older.
// In case there are no pets that meet that criteria, call
// DefaultIfEmpty(). This code passes an (optional) default
// value to DefaultIfEmpty().
string[] oldPets =
    pets.AsQueryable()
    .Where(pet => pet.Age >= 10)
    .Select(pet => pet.Name)
    .DefaultIfEmpty("[EMPTY]")
    .ToArray();

Console.WriteLine("First query: " + oldPets[0]);

// This query selects only those pets that are 10 or older.
// This code does not call DefaultIfEmpty().
string[] oldPets2 =
    pets.AsQueryable()
    .Where(pet => pet.Age >= 10)
    .Select(pet => pet.Name)
    .ToArray();

// There may be no elements in the array, so directly
// accessing element 0 may throw an exception.
try
{
    Console.WriteLine("Second query: " + oldPets2[0]);
}
catch (Exception e)
{
    Console.WriteLine("Second query: An exception was thrown: " + e.Message);
}

/*
    This code produces the following output:

    First query: [EMPTY]
    Second query: An exception was thrown: Index was outside the bounds of the array.
*/

Comentarios

El DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) método genera un MethodCallExpression objeto que representa llamarse DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery<TElement>(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro .

El comportamiento de consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que devuelve source si no está vacío. De lo contrario, devuelve un IQueryable<T> objeto que contiene defaultValue.

DefaultIfEmpty<TSource>(IQueryable<TSource>)

Source:

Queryable.cs

Devuelve los elementos de la secuencia especificada o el valor predeterminado del parámetro de tipo en una colección singleton si la secuencia está vacía.

C#

public static System.Linq.IQueryable<TSource?> DefaultIfEmpty<TSource> (this System.Linq.IQueryable<TSource> source);

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IQueryable<TSource>

IQueryable<T> para el que se va a devolver un valor predeterminado si está vacío.

Devoluciones

IQueryable<TSource>

IQueryable<T> que contiene default(TSource) si source está vacío; de lo contrario, source.

Excepciones

ArgumentNullException

source es null.

Ejemplos

En los ejemplos de código siguientes se muestra cómo usar DefaultIfEmpty<TSource>(IQueryable<TSource>) para proporcionar un valor predeterminado en caso de que la secuencia de origen esté vacía.

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void DefaultIfEmptyEx1()
{
    // Create a list of Pet objects.
    List<Pet> pets =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 } };

    // Call DefaultIfEmtpy() on the collection that Select()
    // returns, so that if the initial list is empty, there
    // will always be at least one item in the returned array.
    string[] names =
        pets.AsQueryable()
        .Select(pet => pet.Name)
        .DefaultIfEmpty()
        .ToArray();

    string first = names[0];
    Console.WriteLine(first);
}

/*
    This code produces the following output:

    Barley
*/

Comentarios

El DefaultIfEmpty<TSource>(IQueryable<TSource>) método genera un MethodCallExpression objeto que representa llamarse DefaultIfEmpty<TSource>(IQueryable<TSource>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery<TElement>(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro .

El comportamiento de consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada DefaultIfEmpty<TSource>(IQueryable<TSource>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que devuelve source si no está vacío. De lo contrario, devuelve un IQueryable<T> objeto que contiene default(TSource).