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.FirstOrDefault<TSource>-Methode: (IEnumerable<TSource>)

 

Veröffentlicht: Oktober 2016

Gibt das erste Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz keine Elemente enthält.

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

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

Parameter

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

Die IEnumerable<T> auf das erste Element zurück.

Rückgabewert

Type: TSource

default(TSource) Wenn source leer ist, andernfalls das erste Element im source.

Typparameter

TSource

Der Typ der Elemente von source.

Exception Condition
ArgumentNullException

source ist null.

Der Standardwert für Referenztypen und Typen ist null.

Die FirstOrDefault Methode bietet keine Möglichkeit, einen Standardwert anzugeben. Wenn Sie als einen Standardwert angeben möchten default(TSource), verwenden Sie die DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) Methode, wie im Beispielabschnitt beschrieben.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie FirstOrDefault<TSource>(IEnumerable<TSource>) für ein leeres Array.

int[] numbers = { };
int first = numbers.FirstOrDefault();
Console.WriteLine(first);

/*
 This code produces the following output:

 0
*/

Der Wert von default(TSource) ist nicht der Standardwert, der zu verwenden, wenn die Auflistung keine Elemente enthält. Anstatt das Ergebnis für den unerwünschten Standardwert zu ändern, wenn erforderlich, können Sie die DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) Methode, um den Standardwert anzugeben, die zu verwenden, wenn die Auflistung leer ist. Anschließend rufen Sie First<TSource>(IEnumerable<TSource>) auf das erste Element abzurufen. Im folgenden Codebeispiel werden beide Verfahren verwendet, den Standardwert 1 zu erhalten, wenn eine Auflistung der numerischen Monate leer ist. Da der Standardwert für eine ganze Zahl 0 und keinem Monat entspricht ist, muss der Standardwert stattdessen als 1 angegeben werden. Die erste Ergebnisvariable wird für den unerwünschten Standardwert geprüft, nachdem die Abfrage ausgeführt wurde. Die zweite Ergebnisvariable wird mithilfe von DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) an den Standardwert 1.

List<int> months = new List<int> { };

// Setting the default value to 1 after the query.
int firstMonth1 = months.FirstOrDefault();
if (firstMonth1 == 0)
{
    firstMonth1 = 1;
}
Console.WriteLine("The value of the firstMonth1 variable is {0}", firstMonth1);

// Setting the default value to 1 by using DefaultIfEmpty() in the query.
int firstMonth2 = months.DefaultIfEmpty(1).First();
Console.WriteLine("The value of the firstMonth2 variable is {0}", firstMonth2);

/*
 This code produces the following output:

 The value of the firstMonth1 variable is 1
 The value of the firstMonth2 variable is 1
*/

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: