Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Enumerable.DefaultIfEmpty<TSource>-Methode: (IEnumerable<TSource>)

 

Veröffentlicht: Oktober 2016

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

Namespace:   System.Linq
Assembly:  System.Core (in System.Core.dll)

public static IEnumerable<TSource> DefaultIfEmpty<TSource>(
	this IEnumerable<TSource> source
)

Parameter

source
Type: System.Collections.Generic.IEnumerable<TSource>

Die Sequenz, für die ein Standardwert zurückgegeben werden soll, wenn sie leer ist.

Rückgabewert

Type: System.Collections.Generic.IEnumerable<TSource>

Ein IEnumerable<T> -Objekt, das den Standardwert für den TSource geben, wenn source leer ist, andernfalls wird source.

Typparameter

TSource

Der Typ der Elemente von source.

Exception Condition
ArgumentNullException

source ist null.

Diese Methode wird mit verzögerter Ausführung implementiert. Der sofortige Rückgabewert ist ein Objekt, das alle Informationen gespeichert hat, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird nicht ausgeführt, bis das Objekt aufgelistet wird, entweder durch Aufrufen der GetEnumerator -Methode direkt oder mithilfe von foreach in Visual C# oder For Each in Visual Basic.

Der Standardwert für Referenztypen und Typen ist null.

Diese Methode kann verwendet werden, um eine linke äußere Verknüpfung zu erstellen, zusammen mit den GroupJoin<TOuter, TInner, TKey, TResult>) Methode.

Im folgenden Codebeispiel wird veranschaulicht, wie mit DefaultIfEmpty<TSource>(IEnumerable<TSource>) einen Standardwert bereitgestellt wird, falls die Quellsequenz leer ist.

Dieses Beispiel verwendet eine nicht leere Sequenz.

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

In diesem Beispiel wird eine leere Sequenz verwendet.

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

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

/*
 This code produces the following output:

 0
*/

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 3.5
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: