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í.

Pokud je sekvence prázdná, vrátí elementy IEnumerable<T>kolekce , nebo s výchozí hodnotou.

Přetížení

DefaultIfEmpty<TSource>(IEnumerable<TSource>)	Vrátí prvky zadané sekvence nebo výchozí hodnotu parametru typu v jednoúčelové kolekci, pokud je sekvence prázdná.
DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource)	Vrátí prvky zadané sekvence nebo zadanou hodnotu v jednoúčelové kolekci, pokud je sekvence prázdná.

DefaultIfEmpty<TSource>(IEnumerable<TSource>)

Source:: DefaultIfEmpty.cs

Source:: DefaultIfEmpty.cs

Source:: DefaultIfEmpty.cs

Vrátí prvky zadané sekvence nebo výchozí hodnotu parametru typu v jednoúčelové 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 elementů .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 TSource typ, pokud source je prázdný; sourcev opačném případě .

Výjimky

ArgumentNullException

source je null.

Příklady

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

V tomto příkladu se používá neprázdná sekvence.

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 není proveden, dokud objekt není výčet buď voláním jeho GetEnumerator metody 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 metodou GroupJoin) .

Viz také

Platí pro

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

Source:: DefaultIfEmpty.cs

Source:: DefaultIfEmpty.cs

Source:: DefaultIfEmpty.cs

Vrátí prvky zadané sekvence nebo zadanou hodnotu v jednoúčelové 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 elementů .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>

Hodnota IEnumerable<T> , která obsahuje defaultValue hodnotu if source , je prázdná, sourcev opačném případě .

Příklady

Následující příklad kódu ukazuje, jak použít metodu DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) 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 metodou GroupJoin) .

Viz také

Platí pro

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

Váš názor

Další materiály