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

Queryable.FirstOrDefault<TSource>-Methode: (IQueryable<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 IQueryable<TSource> source
)

Parameter

source
Type: System.Linq.IQueryable<TSource>

Die IQueryable<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.

Die FirstOrDefault<TSource>(IQueryable<TSource>) -Methode generiert eine MethodCallExpression Aufruf darstellt FirstOrDefault<TSource>(IQueryable<TSource>) sich selbst als konstruierte generische Methode. Anschließend übergibt der MethodCallExpression zu der Execute<TResult>(Expression) Methode der IQueryProvider durch dargestellt die Provider Eigenschaft der source Parameter.

Das Abfrageverhalten durch das Ausführen einer Ausdrucksbaumstruktur, die aufrufende darstellt, FirstOrDefault<TSource>(IQueryable<TSource>) hängt von der Implementierung des Typs der source Parameter. Das erwartete Verhalten ist, wird das erste Element im source, oder ein Standardwert, wenn source ist leer.

Die FirstOrDefault -Methode bietet eine Möglichkeit zum Angeben des Standardwert wird zurückgegeben, wenn keine source ist leer. Wenn Sie als einen Standardwert angeben möchten default(TSource), verwenden Sie die DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) Methode, wie im Beispielabschnitt beschrieben.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie FirstOrDefault<TSource>(IQueryable<TSource>) für eine leere Sequenz.

// Create an empty array.
int[] numbers = { };
// Get the first item in the array, or else the 
// default value for type int (0).
int first = numbers.AsQueryable().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>(IQueryable<TSource>, TSource) Methode, um den Standardwert anzugeben, die zu verwenden, wenn die Auflistung leer ist. Anschließend rufen Sie First<TSource>(IQueryable<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 auf den unerwünschten Standardwert überprüft, nachdem die Abfrage abgeschlossen ist. Die zweite Ergebnisvariable wird durch Aufrufen von DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) an den Standardwert 1.

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

// Setting the default value to 1 after the query.
int firstMonth1 = months.AsQueryable().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.AsQueryable().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.1
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: