Enumerable.First Enumerable.First Enumerable.First Enumerable.First Method

Definizione

Restituisce il primo elemento di una sequenza.Returns the first element of a sequence.

Overload

First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>)

Restituisce il primo elemento di una sequenza.Returns the first element of a sequence.

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

Restituisce il primo elemento in una sequenza che soddisfa una condizione specificata.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>)

Restituisce il primo elemento di una sequenza.Returns the first element of a sequence.

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

Parametri di tipo

TSource

Tipo degli elementi di source.The type of the elements of source.

Parametri

source
IEnumerable<TSource>

Oggetto IEnumerable<T> di cui restituire il primo elemento.The IEnumerable<T> to return the first element of.

Restituisce

TSource TSource TSource TSource

Il primo elemento nella sequenza specificata.The first element in the specified sequence.

Eccezioni

La sequenza di origine è vuota.The source sequence is empty.

Esempi

Nell'esempio di codice riportato di seguito viene First<TSource>(IEnumerable<TSource>) illustrato come utilizzare per restituire il primo elemento di una matrice.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>) to return the first element of an array.

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.
MsgBox(first)

' This code produces the following output:
'
' 9

Commenti

Il First<TSource>(IEnumerable<TSource>) metodo genera un'eccezione se source non contiene elementi.The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Per restituire invece un valore predefinito se la sequenza di origine è vuota, utilizzare FirstOrDefault il metodo.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

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

Restituisce il primo elemento in una sequenza che soddisfa una condizione specificata.Returns the first element in a sequence that satisfies a specified condition.

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

Parametri di tipo

TSource

Tipo degli elementi di source.The type of the elements of source.

Parametri

source
IEnumerable<TSource>

Oggetto IEnumerable<T> dal quale restituire un elemento.An IEnumerable<T> to return an element from.

predicate
Func<TSource,Boolean>

Funzione per testare ogni elemento rispetto a una condizione.A function to test each element for a condition.

Restituisce

TSource TSource TSource TSource

Il primo elemento nella sequenza che supera il test nella funzione predicato specificata.The first element in the sequence that passes the test in the specified predicate function.

Eccezioni

source o predicate è null.source or predicate is null.

Nessun elemento soddisfa la condizione in predicate.No element satisfies the condition in predicate.

-oppure--or- La sequenza di origine è vuota.The source sequence is empty.

Esempi

Nell'esempio di codice riportato di seguito viene First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) illustrato come utilizzare per restituire il primo elemento di una matrice che soddisfa una condizione.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) to return the first element of an array that satisfies a condition.

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.
MsgBox(first)

' This code produces the following output:
'
' 92

Commenti

Il First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) metodo genera un'eccezione se non viene trovato alcun elemento corrispondente sourcein.The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Per restituire invece un valore predefinito quando non viene trovato alcun elemento corrispondente, utilizzare FirstOrDefault il metodo.To instead return a default value when no matching element is found, use the FirstOrDefault method.

Si applica a