Queryable.DefaultIfEmpty Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.Queryable.dll

Gibt die Elemente in einer Sequenz zurück, oder eine Standardwert-Singletonauflistung, wenn die Sequenz leer ist.

Überlädt

DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource)	Gibt die Elemente der angegebenen Sequenz oder den angegebenen Wert in einer Singletonauflistung zurück, wenn die Sequenz leer ist.
DefaultIfEmpty<TSource>(IQueryable<TSource>)	Gibt die Elemente der angegebenen Sequenz oder den Standardwert des Typparameters in einer Singletonauflistung zurück, wenn die Sequenz leer ist

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

Quelle:

Queryable.cs

Gibt die Elemente der angegebenen Sequenz oder den angegebenen Wert in einer Singletonauflistung zurück, wenn die Sequenz leer ist.

C#

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IQueryable<TSource>

Das IQueryable<T>, für das der angegebene Wert zurückgegeben soll, wenn die Sequenz leer ist.

defaultValue

TSource

Der Wert, der zurückgegeben werden soll, wenn die Sequenz leer ist.

Gibt zurück

IQueryable<TSource>

Ein IQueryable<T>, das defaultValue enthält, wenn source leer ist, andernfalls source

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Das folgende Codebeispiel zeigt eine Situation, in der es nützlich ist, eine LINQ-Abfrage aufzurufen DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) . In diesem Beispiel wird ein DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) Standardwert übergeben.

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.
*/

Hinweise

Die DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) -Methode generiert eine MethodCallExpression , die den Aufruf DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) selbst als konstruierte generische Methode darstellt. Anschließend übergibt es die MethodCallExpression an die CreateQuery<TElement>(Expression) -Methode von, die IQueryProvider durch die Provider -Eigenschaft des source Parameters dargestellt wird.

Das Abfrageverhalten, das beim Ausführen einer Ausdrucksstruktur auftritt, die den Aufruf DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) darstellt, hängt von der Implementierung des Typs des source Parameters ab. Das erwartete Verhalten ist, dass es zurückgegeben source wird, wenn es nicht leer ist. Andernfalls wird ein IQueryable<T> zurückgegeben, das enthält defaultValue.

DefaultIfEmpty<TSource>(IQueryable<TSource>)

Quelle:

Queryable.cs

Gibt die Elemente der angegebenen Sequenz oder den Standardwert des Typparameters in einer Singletonauflistung zurück, wenn die Sequenz leer ist

C#

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IQueryable<TSource>

Das IQueryable<T>, für das ein Standardwert zurückgegeben soll, wenn die Sequenz leer ist.

Gibt zurück

IQueryable<TSource>

Ein IQueryable<T>, das default(TSource) enthält, wenn source leer ist, andernfalls source.

Ausnahmen

ArgumentNullException

source ist null.

Beispiele

Die folgenden Codebeispiele veranschaulichen, wie sie verwenden DefaultIfEmpty<TSource>(IQueryable<TSource>) , um einen Standardwert bereitzustellen, falls die Quellsequenz leer ist.

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
*/

Hinweise

Die DefaultIfEmpty<TSource>(IQueryable<TSource>) -Methode generiert eine MethodCallExpression , die den Aufruf DefaultIfEmpty<TSource>(IQueryable<TSource>) selbst als konstruierte generische Methode darstellt. Anschließend übergibt es die MethodCallExpression an die CreateQuery<TElement>(Expression) -Methode von, die IQueryProvider durch die Provider -Eigenschaft des source Parameters dargestellt wird.

Das Abfrageverhalten, das beim Ausführen einer Ausdrucksstruktur auftritt, die den Aufruf DefaultIfEmpty<TSource>(IQueryable<TSource>) darstellt, hängt von der Implementierung des Typs des source Parameters ab. Das erwartete Verhalten ist, dass es zurückgegeben source wird, wenn es nicht leer ist. Andernfalls wird ein IQueryable<T> zurückgegeben, das enthält default(TSource).