Enumerable.FirstOrDefault Metoda
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca pierwszy element sekwencji lub wartość domyślną, jeśli nie znaleziono żadnego elementu.
| FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource) |
Zwraca pierwszy element sekwencji, który spełnia warunek lub określoną wartość domyślną, jeśli taki element nie zostanie znaleziony. |
| FirstOrDefault<TSource>(IEnumerable<TSource>, TSource) |
Zwraca pierwszy element sekwencji lub określoną wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów. |
| FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) |
Zwraca pierwszy element sekwencji, który spełnia warunek lub wartość domyślną, jeśli taki element nie zostanie znaleziony. |
| FirstOrDefault<TSource>(IEnumerable<TSource>) |
Zwraca pierwszy element sekwencji lub wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów. |
- Źródło:
- First.cs
- Źródło:
- First.cs
- Źródło:
- First.cs
Zwraca pierwszy element sekwencji, który spełnia warunek lub określoną wartość domyślną, jeśli taki element nie zostanie znaleziony.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate, TSource defaultValue);public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate, TSource defaultValue);static member FirstOrDefault : seq<'Source> * Func<'Source, bool> * 'Source -> 'Source<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), defaultValue As TSource) As TSourceParametry typu
- TSource
Typ elementów elementu source.
Parametry
- source
- IEnumerable<TSource>
Element do IEnumerable<T> zwrócenia elementu z.
- defaultValue
- TSource
Wartość domyślna, która ma być zwracana, jeśli sekwencja jest pusta.
Zwraca
defaultValue jeśli source jest pusty lub jeśli żaden element nie przejdzie testu określonego przez predicate; w przeciwnym razie pierwszy element w source tym przechodzi test określony przez predicate.
Wyjątki
source lub predicate to null.
Dotyczy
.NET 9 i inne wersje
| Produkt | Wersje |
|---|---|
| .NET | 6, 7, 8, 9 |
- Źródło:
- First.cs
- Źródło:
- First.cs
- Źródło:
- First.cs
Zwraca pierwszy element sekwencji lub określoną wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource defaultValue);public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource defaultValue);static member FirstOrDefault : seq<'Source> * 'Source -> 'Source<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IEnumerable(Of TSource), defaultValue As TSource) As TSourceParametry typu
- TSource
Typ elementów elementu source.
Parametry
- source
- IEnumerable<TSource>
Element IEnumerable<T> , aby zwrócić pierwszy element.
- defaultValue
- TSource
Wartość domyślna, która ma być zwracana, jeśli sekwencja jest pusta.
Zwraca
defaultValue jeśli source jest pusty; w przeciwnym razie pierwszy element w sourceelemecie .
Wyjątki
source to null.
Dotyczy
.NET 9 i inne wersje
| Produkt | Wersje |
|---|---|
| .NET | 6, 7, 8, 9 |
- Źródło:
- First.cs
- Źródło:
- First.cs
- Źródło:
- First.cs
Zwraca pierwszy element sekwencji, który spełnia warunek lub wartość domyślną, jeśli taki element nie zostanie znaleziony.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);public static TSource? FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);static member FirstOrDefault : seq<'Source> * Func<'Source, bool> -> 'Source<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As TSourceParametry typu
- TSource
Typ elementów elementu source.
Parametry
- source
- IEnumerable<TSource>
Element do IEnumerable<T> zwrócenia elementu z.
Zwraca
default(TSource) jeśli source jest pusty lub jeśli żaden element nie przeszedł testu określonego przez predicate; w przeciwnym razie pierwszy element w source tym przechodzi test określony przez predicate.
Wyjątki
source lub predicate to null.
Przykłady
W poniższym przykładzie kodu pokazano, jak używać FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) , przekazując predykat. W drugim wywołaniu metody nie ma elementu w tablicy, który spełnia warunek.
string[] names = { "Hartono, Tommy", "Adams, Terry",
"Andersen, Henriette Thaulow",
"Hedlund, Magnus", "Ito, Shu" };
string firstLongName = names.FirstOrDefault(name => name.Length > 20);
Console.WriteLine("The first long name is '{0}'.", firstLongName);
string firstVeryLongName = names.FirstOrDefault(name => name.Length > 30);
Console.WriteLine(
"There is {0} name longer than 30 characters.",
string.IsNullOrEmpty(firstVeryLongName) ? "not a" : "a");
/*
This code produces the following output:
The first long name is 'Andersen, Henriette Thaulow'.
There is not a name longer than 30 characters.
*/
' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}
' Select the first string in the array whose length is greater than 20.
Dim firstLongName As String =
names.FirstOrDefault(Function(name) name.Length > 20)
' Display the output.
Console.WriteLine($"The first long name is {firstLongName}")
' Select the first string in the array whose length is greater than 30,
' or a default value if there are no such strings in the array.
Dim firstVeryLongName As String =
names.FirstOrDefault(Function(name) name.Length > 30)
Dim text As String = IIf(String.IsNullOrEmpty(firstVeryLongName), "not a", "a")
Console.WriteLine($"There is {text} name longer than 30 characters.")
' This code produces the following output:
'
' The first long name is Andersen, Henriette Thaulow
'
' There is not a name longer than 30 characters.
Uwagi
Wartością domyślną dla typów referencyjnych i dopuszczalnych wartości null jest null.
Dotyczy
.NET 9 i inne wersje
| Produkt | Wersje |
|---|---|
| .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 |
- Źródło:
- First.cs
- Źródło:
- First.cs
- Źródło:
- First.cs
Zwraca pierwszy element sekwencji lub wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source);public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);public static TSource? FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);static member FirstOrDefault : seq<'Source> -> 'Source<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IEnumerable(Of TSource)) As TSourceParametry typu
- TSource
Typ elementów elementu source.
Parametry
- source
- IEnumerable<TSource>
Element IEnumerable<T> , aby zwrócić pierwszy element.
Zwraca
default(TSource) jeśli source jest pusty; w przeciwnym razie pierwszy element w sourcepliku .
Wyjątki
source to null.
Przykłady
W poniższym przykładzie kodu pokazano, jak używać FirstOrDefault<TSource>(IEnumerable<TSource>) w pustej tablicy.
int[] numbers = { };
int first = numbers.FirstOrDefault();
Console.WriteLine(first);
/*
This code produces the following output:
0
*/
' Create an empty array.
Dim numbers() As Integer = {}
' Select the first element in the array, or a default value
' if there are not elements in the array.
Dim first As Integer = numbers.FirstOrDefault()
' Display the output.
Console.WriteLine(first)
' This code produces the following output:
'
' 0
Czasami wartość nie default(TSource) jest wartością domyślną, której chcesz użyć, jeśli kolekcja nie zawiera żadnych elementów. Zamiast sprawdzać wynik dla niepożądanej wartości domyślnej, a następnie zmienić ją w razie potrzeby, możesz użyć metody , aby określić wartość domyślną, której chcesz użyć DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) , jeśli kolekcja jest pusta. Następnie wywołaj metodę First<TSource>(IEnumerable<TSource>) , aby uzyskać pierwszy element. Poniższy przykład kodu używa obu technik w celu uzyskania wartości domyślnej 1, jeśli kolekcja miesięcy liczbowych jest pusta. Ponieważ wartość domyślna liczby całkowitej wynosi 0, która nie odpowiada żadnemu miesiącowi, wartość domyślna musi być określona jako 1. Pierwsza zmienna wynikowa jest sprawdzana pod kątem niepożądanej wartości domyślnej po zakończeniu wykonywania zapytania. Druga zmienna wynikowa jest uzyskiwana przy użyciu metody DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) , aby określić wartość domyślną 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
*/
Dim months As New List(Of Integer)(New Integer() {})
' Setting the default value to 1 after the query.
Dim firstMonth1 As Integer = months.FirstOrDefault()
If firstMonth1 = 0 Then
firstMonth1 = 1
End If
Console.WriteLine($"The value of the firstMonth1 variable is {firstMonth1}")
' Setting the default value to 1 by using DefaultIfEmpty() in the query.
Dim firstMonth2 As Integer = months.DefaultIfEmpty(1).First()
Console.WriteLine($"The value of the firstMonth2 variable is {firstMonth2}")
' This code produces the following output:
'
' The value of the firstMonth1 variable is 1
' The value of the firstMonth2 variable is 1
Uwagi
Wartością domyślną dla typów referencyjnych i dopuszczalnych wartości null jest null.
Metoda FirstOrDefault nie zapewnia sposobu określania wartości domyślnej. Jeśli chcesz określić wartość domyślną inną niż default(TSource), użyj DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) metody zgodnie z opisem w sekcji Przykład.
Dotyczy
.NET 9 i inne wersje
| Produkt | Wersje |
|---|---|
| .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 |
Opinia o produkcie .NET
.NET to projekt typu open source. Wybierz link, aby przekazać opinię: