Enumerable.DefaultIfEmpty Metoda

Reference

Definice

Obor názvů:: System.Linq

Sestavení:: System.Linq.dll

Sestavení:: System.Core.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ DefaultIfEmpty(System::Collections::Generic::IEnumerable<TSource> ^ source);

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

static member DefaultIfEmpty : seq<'Source> -> seq<'Source>

<Extension()>
Public Function DefaultIfEmpty(Of TSource) (source As IEnumerable(Of TSource)) As IEnumerable(Of TSource)

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

ArgumentNullException

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

Structure Pet
    Public Name As String
    Public Age As Integer
End Structure

Sub DefaultIfEmptyEx1()
    ' Create a List of Pet objects.
    Dim pets As New List(Of Pet)(New Pet() _
                         {New Pet With {.Name = "Barley", .Age = 8},
                          New Pet With {.Name = "Boots", .Age = 4},
                          New Pet With {.Name = "Whiskers", .Age = 1}})

    Dim output As New System.Text.StringBuilder
    ' Iterate through the items in the List, calling DefaultIfEmpty().
    For Each pet As Pet In pets.DefaultIfEmpty()
        output.AppendLine(pet.Name)
    Next

    ' Display the output.
    Console.WriteLine(output.ToString())
End Sub

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

' Create an empty List.
Dim numbers As New List(Of Integer)()

Dim output As New System.Text.StringBuilder
' Iterate through the items in the List, calling DefaultIfEmpty().
For Each number As Integer In numbers.DefaultIfEmpty()
    output.AppendLine(number)
Next

' Display the output.
Console.WriteLine(output.ToString())

' 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é

operace spojení (C#)
operací připojení (Visual Basic)

Platí pro

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:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ DefaultIfEmpty(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource defaultValue);

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

static member DefaultIfEmpty : seq<'Source> * 'Source -> seq<'Source>

<Extension()>
Public Function DefaultIfEmpty(Of TSource) (source As IEnumerable(Of TSource), defaultValue As TSource) As IEnumerable(Of TSource)

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

Structure Pet
    Public Name As String
    Public Age As Integer
End Structure

Sub DefaultIfEmptyEx2()
    ' Create a Pet object to use as the default value.
    Dim defaultPet As New Pet With {.Name = "Default Pet", .Age = 0}

    ' Create a List of Pet objects.
    Dim pets1 As New List(Of Pet)(New Pet() _
                          {New Pet With {.Name = "Barley", .Age = 8},
                           New Pet With {.Name = "Boots", .Age = 4},
                           New Pet With {.Name = "Whiskers", .Age = 1}})

    Dim output1 As New System.Text.StringBuilder
    ' Enumerate the items in the list, calling DefaultIfEmpty()
    ' with a default value.
    For Each pet As Pet In pets1.DefaultIfEmpty(defaultPet)
        output1.AppendLine("Name: " & pet.Name)
    Next

    ' Display the output.
    Console.WriteLine(output1.ToString())

    ' Create an empty List.
    Dim pets2 As New List(Of Pet)

    Dim output2 As New System.Text.StringBuilder
    ' Enumerate the items in the list, calling DefaultIfEmpty()
    ' with a default value.
    For Each pet As Pet In pets2.DefaultIfEmpty(defaultPet)
        output2.AppendLine("Name: " & pet.Name)
    Next

    ' Display the output.
    Console.WriteLine(output2.ToString())
End Sub

' This code produces the following output:
'
' Name: Barley
' Name: Boots
' Name: Whiskers
'
' Name: Default Pet

Poznámky

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

Viz také

operace spojení (C#)
operací připojení (Visual Basic)

Platí pro

Sdílet prostřednictvím

Enumerable.DefaultIfEmpty Metoda

Definice

Přetížení

DefaultIfEmpty<TSource>(IEnumerable<TSource>)

Parametry typu

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

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

Parametry typu

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

Další materiály