Enumerable.SingleOrDefault Methode

Referenz

Definition

Namespace:: System.Linq

Assembly:: System.Linq.dll

Assembly:: System.Core.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt ein einzelnes spezifisches Element einer Sequenz oder einen Standardwert zurück, wenn dieses Element nicht gefunden wird

Überlädt

SingleOrDefault<TSource>(IEnumerable<TSource>)	Gibt das einzige Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz leer ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente in der Sequenz vorhanden sind.
SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Gibt das einzige Element einer Sequenz, das eine angegebene Bedingung erfüllt, oder einen Standardwert zurück, wenn kein solches Element vorhanden ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen.
SingleOrDefault<TSource>(IEnumerable<TSource>, TSource)	Gibt das einzige Element einer Sequenz oder einen angegebenen Standardwert zurück, wenn die Sequenz leer ist. Diese Methode löst eine Ausnahme aus, wenn mehr als ein Element in der Sequenz vorhanden ist.
SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)	Gibt das einzige Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt, oder einen angegebenen Standardwert, wenn kein solches Element vorhanden ist; Diese Methode löst eine Ausnahme aus, wenn mehr als ein Element die Bedingung erfüllt.

SingleOrDefault<TSource>(IEnumerable<TSource>)

Quelle:: Single.cs

Quelle:: Single.cs

Quelle:: Single.cs

Gibt das einzige Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz leer ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente in der Sequenz vorhanden sind.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource SingleOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source);

public static TSource SingleOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

public static TSource? SingleOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

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

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source: IEnumerable<TSource>

Ein IEnumerable<T>, dessen einziges Element zurückgegeben werden soll

Gibt zurück

TSource

Das einzige Element der Eingabesequenz oder default(TSource), wenn die Sequenz keine Elemente enthält

Ausnahmen

ArgumentNullException

source ist null.

InvalidOperationException

Die Eingabesequenz enthält mehr als ein Element.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie SingleOrDefault<TSource>(IEnumerable<TSource>) das einzige Element eines Arrays ausgewählt wird.

string[] fruits1 = { "orange" };

string fruit1 = fruits1.SingleOrDefault();

Console.WriteLine(fruit1);

/*
 This code produces the following output:

 orange
*/

' Create an array that contains one item.
Dim fruits1() As String = {"orange"}

' Get the single item in the array or else a default value.
Dim result As String = fruits1.SingleOrDefault()

' Display the result.
Console.WriteLine($"First array: {result}")

Im folgenden Codebeispiel wird veranschaulicht, dass SingleOrDefault<TSource>(IEnumerable<TSource>) ein Standardwert zurückgegeben wird, wenn die Sequenz leer ist.

string[] fruits2 = { };

string fruit2 = fruits2.SingleOrDefault();

Console.WriteLine(
    String.IsNullOrEmpty(fruit2) ? "No such string!" : fruit2);

/*
 This code produces the following output:

 No such string!
*/

' Create an empty array.
Dim fruits2() As String = {}

result = String.Empty

' Get the single item in the array or else a default value.
result = fruits2.SingleOrDefault()

' Display the result.
Dim output As String =
IIf(String.IsNullOrEmpty(result), "No single item found", result)
Console.WriteLine($"Second array: {output}")

' This code produces the following output:
'
' First array: orange
' Second array: No single item found

Manchmal ist der Wert von default(TSource) nicht der Standardwert, den Sie verwenden möchten, wenn die Auflistung keine Elemente enthält. Anstatt das Ergebnis auf den unerwünschten Standardwert zu überprüfen und ihn bei Bedarf zu ändern, können Sie die DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) -Methode verwenden, um den Standardwert anzugeben, den Sie verwenden möchten, wenn die Auflistung leer ist. Rufen Sie dann auf Single<TSource>(IEnumerable<TSource>) , um das -Element abzurufen. Im folgenden Codebeispiel werden beide Techniken verwendet, um den Standardwert 1 abzurufen, wenn eine Sammlung von Seitenzahlen leer ist. Da der Standardwert für eine ganze Zahl 0 ist, was normalerweise keine gültige Seitenzahl ist, muss der Standardwert stattdessen als 1 angegeben werden. Die erste Ergebnisvariable wird nach Abschluss der Ausführung der Abfrage auf den unerwünschten Standardwert überprüft. Die zweite Ergebnisvariable wird mithilfe von verwendet, DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) um den Standardwert 1 anzugeben.

int[] pageNumbers = { };

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

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

/*
 This code produces the following output:

 The value of the pageNumber1 variable is 1
 The value of the pageNumber2 variable is 1
*/

Dim pageNumbers() As Integer = {}

' Setting the default value to 1 after the query.
Dim pageNumber1 As Integer = pageNumbers.SingleOrDefault()
If pageNumber1 = 0 Then
    pageNumber1 = 1
End If
Console.WriteLine($"The value of the pageNumber1 variable is {pageNumber1}")

' Setting the default value to 1 by using DefaultIfEmpty() in the query.
Dim pageNumber2 As Integer = pageNumbers.DefaultIfEmpty(1).Single()
Console.WriteLine($"The value of the pageNumber2 variable is {pageNumber2}")

' This code produces the following output:

' The value of the pageNumber1 variable is 1
' The value of the pageNumber2 variable is 1

Hinweise

Der Standardwert für Verweis- und NULLable-Typen ist null.

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

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Quelle:: Single.cs

Quelle:: Single.cs

Quelle:: Single.cs

Gibt das einzige Element einer Sequenz, das eine angegebene Bedingung erfüllt, oder einen Standardwert zurück, wenn kein solches Element vorhanden ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource SingleOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);

public static TSource SingleOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

public static TSource? SingleOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

static member SingleOrDefault : seq<'Source> * Func<'Source, bool> -> 'Source

<Extension()>
Public Function SingleOrDefault(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As TSource

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source: IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein einzelnes Element zurückgegeben werden soll

predicate: Func<TSource,Boolean>

Eine Funktion zum Überprüfen eines Elements auf eine Bedingung.

Gibt zurück

TSource

Gibt das einzige Element der Eingabesequenz, das die Bedingung erfüllt, oder default(TSource) zurück, wenn ein solches Element nicht gefunden wird.

Ausnahmen

ArgumentNullException

source oder predicate ist null.

InvalidOperationException

Die Bedingung in predicate wird von mehreren Elementen erfüllt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) das einzige Element eines Arrays ausgewählt wird, das eine Bedingung erfüllt.

string[] fruits = { "apple", "banana", "mango",
                      "orange", "passionfruit", "grape" };

string fruit1 = fruits.SingleOrDefault(fruit => fruit.Length > 10);

Console.WriteLine(fruit1);

/*
 This code produces the following output:

 passionfruit
*/

' Create an array of strings.
Dim fruits() As String =
{"apple", "banana", "mango", "orange", "passionfruit", "grape"}

' Get the single item in the array whose length is > 10.
Dim fruit1 As String =
fruits.SingleOrDefault(Function(fruit) fruit.Length > 10)

' Display the result.
Console.WriteLine($"First array: {fruit1}")

Das folgende Codebeispiel veranschaulicht, dass SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) einen Standardwert zurückgibt, wenn die Sequenz keine Elemente enthält, die die Bedingung erfüllen.

string fruit2 =
    fruits.SingleOrDefault(fruit => fruit.Length > 15);

Console.WriteLine(
    String.IsNullOrEmpty(fruit2) ? "No such string!" : fruit2);

/*
 This code produces the following output:

 No such string!
*/

' Get the single item in the array whose length is > 15.
Dim fruit2 As String =
fruits.SingleOrDefault(Function(fruit) fruit.Length > 15)

' Display the result.
Dim output As String =
IIf(String.IsNullOrEmpty(fruit2), "No single item found", fruit2)
Console.WriteLine($"Second array: {output}")

' This code produces the following output:
'
' First array: passionfruit
' Second array: No single item found

Hinweise

Der Standardwert für Verweis- und NULLable-Typen ist null.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

SingleOrDefault<TSource>(IEnumerable<TSource>, TSource)

Quelle:: Single.cs

Quelle:: Single.cs

Quelle:: Single.cs

Gibt das einzige Element einer Sequenz oder einen angegebenen Standardwert zurück, wenn die Sequenz leer ist. Diese Methode löst eine Ausnahme aus, wenn mehr als ein Element in der Sequenz vorhanden ist.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource SingleOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource defaultValue);

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

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

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source: IEnumerable<TSource>

Ein IEnumerable<T>, dessen einziges Element zurückgegeben werden soll

defaultValue: TSource

Der Standardwert, der zurückgegeben werden soll, wenn die Sequenz leer ist.

Gibt zurück

TSource

Das einzelne Element der Eingabesequenz oder defaultValue , wenn die Sequenz keine Elemente enthält.

Ausnahmen

ArgumentNullException

source ist null.

InvalidOperationException

Die Eingabesequenz enthält mehr als ein Element.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	6, 7, 8, 9

SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)

Quelle:: Single.cs

Quelle:: Single.cs

Quelle:: Single.cs

Gibt das einzige Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt, oder einen angegebenen Standardwert, wenn kein solches Element vorhanden ist; Diese Methode löst eine Ausnahme aus, wenn mehr als ein Element die Bedingung erfüllt.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource SingleOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate, TSource defaultValue);

public static TSource SingleOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate, TSource defaultValue);

static member SingleOrDefault : seq<'Source> * Func<'Source, bool> * 'Source -> 'Source

<Extension()>
Public Function SingleOrDefault(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), defaultValue As TSource) As TSource

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source: IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein einzelnes Element zurückgegeben werden soll

predicate: Func<TSource,Boolean>

Eine Funktion zum Überprüfen eines Elements auf eine Bedingung.

defaultValue: TSource

Der Standardwert, der zurückgegeben werden soll, wenn die Sequenz leer ist.

Gibt zurück

TSource

Das einzelne Element der Eingabesequenz, das die Bedingung erfüllt, oder defaultValue , wenn kein solches Element gefunden wird.

Ausnahmen

ArgumentNullException

source oder predicate ist null.

InvalidOperationException

Die Bedingung in predicate wird von mehreren Elementen erfüllt.

Gilt für:

.NET 9 und andere Versionen

Produkt	Versionen
.NET	6, 7, 8, 9

Freigeben über

Enumerable.SingleOrDefault Methode

Definition

Überlädt

SingleOrDefault<TSource>(IEnumerable<TSource>)

Typparameter

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Typparameter

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Gilt für:

SingleOrDefault<TSource>(IEnumerable<TSource>, TSource)

Typparameter

Parameter

Gibt zurück

Ausnahmen

Gilt für:

SingleOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)

Typparameter

Parameter

Gibt zurück

Ausnahmen

Gilt für:

Zusätzliche Ressourcen