Enumerable.DefaultIfEmpty Metoda

Definice

Vrátí prvky IEnumerable<T>nebo výchozí kolekci singleton s hodnotou, pokud je sekvence prázdná.

Přetížení

DefaultIfEmpty<TSource>(IEnumerable<TSource>)

Vrátí prvky zadané sekvence nebo výchozí hodnotu parametru typu v jednotonové kolekci, pokud je sekvence prázdná.

DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)

Vrátí prvky zadané sekvence nebo zadanou hodnotu v jednotonové kolekci, pokud je sekvence prázdná.

DefaultIfEmpty<TSource>(IEnumerable<TSource>)

Zdroj:
DefaultIfEmpty.cs
Zdroj:
DefaultIfEmpty.cs
Zdroj:
DefaultIfEmpty.cs

Vrátí prvky zadané sekvence nebo výchozí hodnotu parametru typu v jednotonové kolekci, pokud je sekvence prázdná.

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

Parametry typu

TSource

Typ prvků source.

Parametry

source
IEnumerable<TSource>

Sekvence, která vrátí výchozí hodnotu, pokud je prázdná.

Návraty

IEnumerable<TSource>

Objekt IEnumerable<T>, který obsahuje výchozí hodnotu pro typ TSource, pokud je source prázdný; jinak source.

Výjimky

source je null.

Příklady

Následující příklady kódu ukazují, jak použít DefaultIfEmpty<TSource>(IEnumerable<TSource>) k poskytnutí výchozí hodnoty v případě, že je zdrojová sekvence prázdná.

Tento příklad používá neprázdnou sekvenci.

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

public static void DefaultIfEmptyEx1()
{
    List<Pet> pets =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 } };

    foreach (Pet pet in pets.DefaultIfEmpty())
    {
        Console.WriteLine(pet.Name);
    }
}

/*
 This code produces the following output:

 Barley
 Boots
 Whiskers
*/

Tento příklad používá prázdnou sekvenci.

List<int> numbers = new List<int>();

foreach (int number in numbers.DefaultIfEmpty())
{
    Console.WriteLine(number);
}

/*
 This code produces the following output:

 0
*/

Poznámky

Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou se nespustí, dokud objekt nevyčte buď voláním metody GetEnumerator přímo, nebo pomocí foreach v jazyce C# nebo For Each v jazyce Visual Basic.

Výchozí hodnota pro odkazy a typy s možnou hodnotou null je null.

Tuto metodu lze použít k vytvoření levého vnějšího spojení v kombinaci s GroupJoin metodou.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)

Zdroj:
DefaultIfEmpty.cs
Zdroj:
DefaultIfEmpty.cs
Zdroj:
DefaultIfEmpty.cs

Vrátí prvky zadané sekvence nebo zadanou hodnotu v jednotonové kolekci, pokud je sekvence prázdná.

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

Parametry typu

TSource

Typ prvků source.

Parametry

source
IEnumerable<TSource>

Sekvence, která vrátí zadanou hodnotu, pokud je prázdná.

defaultValue
TSource

Hodnota, která se má vrátit, pokud je sekvence prázdná.

Návraty

IEnumerable<TSource>

IEnumerable<T>, který obsahuje defaultValue, pokud je source prázdný; jinak source.

Příklady

Následující příklad kódu ukazuje, jak použít DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) metoda a zadat výchozí hodnotu. První sekvence není prázdná a druhá sekvence je prázdná.

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

public static void DefaultIfEmptyEx2()
{
    Pet defaultPet = new Pet { Name = "Default Pet", Age = 0 };

    List<Pet> pets1 =
        new List<Pet>{ new Pet { Name="Barley", Age=8 },
                       new Pet { Name="Boots", Age=4 },
                       new Pet { Name="Whiskers", Age=1 } };

    foreach (Pet pet in pets1.DefaultIfEmpty(defaultPet))
    {
        Console.WriteLine("Name: {0}", pet.Name);
    }

    List<Pet> pets2 = new List<Pet>();

    foreach (Pet pet in pets2.DefaultIfEmpty(defaultPet))
    {
        Console.WriteLine("\nName: {0}", pet.Name);
    }
}

/*
 This code produces the following output:

 Name: Barley
 Name: Boots
 Name: Whiskers

 Name: Default Pet
*/

Poznámky

Tato metoda se implementuje pomocí odloženého spuštění. Okamžitá návratová hodnota je objekt, který ukládá všechny informace potřebné k provedení akce. Dotaz reprezentovaný touto metodou se nespustí, dokud objekt nevyčte buď voláním metody GetEnumerator přímo, nebo pomocí foreach v jazyce C# nebo For Each v jazyce Visual Basic.

Tuto metodu lze použít k vytvoření levého vnějšího spojení v kombinaci s GroupJoin metodou.

Viz také

Platí pro

.NET 9 a další verze
Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0