Enumerable.First Methode

Definitie

Naamruimte:
System.Linq
Assembly's:
System.Core.dll, System.Linq.dll
Assembly's:
netstandard.dll, System.Linq.dll
Assembly:
System.Linq.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Retourneert het eerste element van een reeks.

Overloads

Name Description
First<TSource>(IEnumerable<TSource>)

Retourneert het eerste element van een reeks.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Retourneert het eerste element in een reeks die voldoet aan een opgegeven voorwaarde.

First<TSource>(IEnumerable<TSource>)

Bron:
First.cs
Bron:
First.cs
Bron:
First.cs
Bron:
First.cs
Bron:
First.cs

Retourneert het eerste element van een reeks.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Collections::Generic::IEnumerable<TSource> ^ source);
public static TSource First<TSource>(this System.Collections.Generic.IEnumerable<TSource> source);
static member First : seq<'Source> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IEnumerable(Of TSource)) As TSource

Type parameters

TSource

Het type van de elementen van source.

Parameters

source
IEnumerable<TSource>

De IEnumerable<T> om het eerste element van te retourneren.

Retouren

TSource

Het eerste element in de opgegeven reeks.

Uitzonderingen

ArgumentNullException

source is null.

InvalidOperationException

De bronvolgorde is leeg.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u First<TSource>(IEnumerable<TSource>) het eerste element van een matrix retourneert.

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                    83, 23, 87, 435, 67, 12, 19 };

int first = numbers.First();

Console.WriteLine(first);

/*
 This code produces the following output:

 9
*/

' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array.
Dim first As Integer = numbers.First()

' Display the output.
Console.WriteLine(first)

' This code produces the following output:
'
' 9

Opmerkingen

De First<TSource>(IEnumerable<TSource>) methode genereert een uitzondering als source deze geen elementen bevat. Als u in plaats daarvan een standaardwaarde wilt retourneren wanneer de bronreeks leeg is, gebruikt u de FirstOrDefault methode.

Van toepassing op

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

Bron:
First.cs
Bron:
First.cs
Bron:
First.cs
Bron:
First.cs
Bron:
First.cs

Retourneert het eerste element in een reeks die voldoet aan een opgegeven voorwaarde.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);
public static TSource First<TSource>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);
static member First : seq<'Source> * Func<'Source, bool> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As TSource

Type parameters

TSource

Het type van de elementen van source.

Parameters

source
IEnumerable<TSource>

Een IEnumerable<T> om een element van te retourneren.

predicate
Func<TSource,Boolean>

Een functie om elk element voor een voorwaarde te testen.

Retouren

TSource

Het eerste element in de reeks die de test doorgeeft in de opgegeven predicaatfunctie.

Uitzonderingen

ArgumentNullException

source of predicate is null.

InvalidOperationException

Geen element voldoet aan de voorwaarde in predicate.

– of –

De bronvolgorde is leeg.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) het eerste element van een matrix retourneert dat voldoet aan een voorwaarde.

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                    83, 23, 87, 435, 67, 12, 19 };

int first = numbers.First(number => number > 80);

Console.WriteLine(first);

/*
 This code produces the following output:

 92
*/

' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array whose value is greater than 80.
Dim first As Integer = numbers.First(Function(number) number > 80)

' Display the output.
Console.WriteLine(first)

' This code produces the following output:
'
' 92

Opmerkingen

De First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) methode genereert een uitzondering als er geen overeenkomend element wordt gevonden in source. Als u in plaats daarvan een standaardwaarde wilt retourneren wanneer er geen overeenkomend element wordt gevonden, gebruikt u de FirstOrDefault methode.

Van toepassing op