Enumerable.ElementAtOrDefault Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
| ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index) |
Retourne l’élément situé à un index spécifié dans une séquence ou une valeur par défaut si l’index est hors limites. |
| ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32) |
Retourne l’élément situé à un index spécifié dans une séquence ou une valeur par défaut si l’index est hors limites. |
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
Retourne l’élément situé à un index spécifié dans une séquence ou une valeur par défaut si l’index est hors limites.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource ElementAtOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Index index);public static TSource? ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Index index);static member ElementAtOrDefault : seq<'Source> * Index -> 'Source<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IEnumerable(Of TSource), index As Index) As TSourceParamètres de type
- TSource
Le type des éléments de source.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> à partir duquel retourner un élément.
- index
- Index
Index de l’élément à récupérer, à partir du début ou de la fin de la séquence.
Retours
default si index est en dehors des limites de la source séquence ; sinon, l’élément à la position spécifiée dans la source séquence.
Exceptions
source a la valeur null.
Remarques
Si le type de source implémente IList<T>, cette implémentation est utilisée pour obtenir l’élément à l’index spécifié. Sinon, cette méthode obtient l’élément spécifié.
La valeur par défaut pour les types référence et nullables est null.
S’applique à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | 6, 7, 8, 9 |
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
Retourne l’élément situé à un index spécifié dans une séquence ou une valeur par défaut si l’index est hors limites.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource ElementAtOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, int index);public static TSource ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int index);public static TSource? ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int index);static member ElementAtOrDefault : seq<'Source> * int -> 'Source<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IEnumerable(Of TSource), index As Integer) As TSourceParamètres de type
- TSource
Le type des éléments de source.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> à partir duquel retourner un élément.
- index
- Int32
Index de base zéro de l'élément à récupérer.
Retours
default (TSource) si l'index est en dehors des limites de la séquence source ; sinon, l'élément situé à la position spécifiée dans la séquence source.
Exceptions
source a la valeur null.
Exemples
L'exemple de code suivant illustre l'utilisation de ElementAtOrDefault. Cet exemple utilise un index qui se trouve en dehors des limites du tableau.
string[] names =
{ "Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow",
"Hedlund, Magnus", "Ito, Shu" };
int index = 20;
string name = names.ElementAtOrDefault(index);
Console.WriteLine(
"The name chosen at index {0} is '{1}'.",
index,
String.IsNullOrEmpty(name) ? "<no name at this index>" : name);
/*
This code produces the following output:
The name chosen at index 20 is '<no name at this index>'.
*/
' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}
Dim index As Integer = 20
' Get a string at an index that is out of range in the array.
Dim name As String = names.ElementAtOrDefault(index)
Dim text As String = If(String.IsNullOrEmpty(name), "[THERE IS NO NAME AT THIS INDEX]", name)
' Display the output.
Console.WriteLine($"The name chosen at index {index} is {text}")
' This code produces the following output:
'
' The name chosen at index 20 is [THERE IS NO NAME AT THIS INDEX]
Remarques
Si le type de source implémente IList<T>, cette implémentation est utilisée pour obtenir l’élément à l’index spécifié. Sinon, cette méthode obtient l’élément spécifié.
La valeur par défaut pour les types référence et nullables est null.
S’applique à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .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 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires: