Enumerable.Single 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.
Retourne un élément spécifique unique d'une séquence.
| Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) |
Retourne le seul élément d’une séquence qui satisfait à une condition spécifique ou lève une exception si cette séquence contient plusieurs éléments respectant cette condition. |
| Single<TSource>(IEnumerable<TSource>) |
Retourne l’élément unique d’une séquence ou lève une exception si cette séquence ne contient pas un seul élément. |
- Source:
- Single.cs
- Source:
- Single.cs
- Source:
- Single.cs
Retourne le seul élément d’une séquence qui satisfait à une condition spécifique ou lève une exception si cette séquence contient plusieurs éléments respectant cette condition.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource Single(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);public static TSource Single<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);static member Single : seq<'Source> * Func<'Source, bool> -> 'Source<Extension()>
Public Function Single(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As TSourceParamètres de type
- TSource
Le type des éléments de source.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> duquel retourner un seul élément.
Retours
Seul élément de la séquence d'entrée à satisfaire à une condition.
Exceptions
source ou predicate est null.
Aucun élément ne satisfait la condition dans predicate.
- ou -
Plusieurs éléments satisfont à la condition dans predicate.
- ou -
La séquence source est vide.
Exemples
L’exemple de code suivant montre comment utiliser Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) pour sélectionner le seul élément d’un tableau qui répond à une condition.
string[] fruits = { "apple", "banana", "mango",
"orange", "passionfruit", "grape" };
string fruit1 = fruits.Single(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 greater than 10.
Dim result As String =
fruits.Single(Function(fruit) fruit.Length > 10)
' Display the result.
Console.WriteLine($"First query: {result}")
L’exemple de code suivant montre que Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) lève une exception lorsque la séquence ne contient pas exactement un élément qui satisfait à la condition.
string fruit2 = null;
try
{
fruit2 = fruits.Single(fruit => fruit.Length > 15);
}
catch (System.InvalidOperationException)
{
Console.WriteLine(@"The collection does not contain exactly
one element whose length is greater than 15.");
}
Console.WriteLine(fruit2);
// This code produces the following output:
//
// The collection does not contain exactly
// one element whose length is greater than 15.
result = String.Empty
' Try to get the single item in the array whose length is > 15.
Try
result = fruits.Single(Function(fruit) _
fruit.Length > 15)
Catch ex As System.InvalidOperationException
result = "There is not EXACTLY ONE element whose length is > 15."
End Try
' Display the result.
Console.WriteLine($"Second query: {result}")
' This code produces the following output:
'
' First query: passionfruit
' Second query: There is not EXACTLY ONE element whose length is > 15.
Remarques
La Single<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) méthode lève une exception si la séquence d’entrée ne contient aucun élément correspondant. Pour retourner null à la place lorsqu’aucun élément correspondant n’est trouvé, utilisez SingleOrDefault.
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 |
- Source:
- Single.cs
- Source:
- Single.cs
- Source:
- Single.cs
Retourne l’élément unique d’une séquence ou lève une exception si cette séquence ne contient pas un seul élément.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource Single(System::Collections::Generic::IEnumerable<TSource> ^ source);public static TSource Single<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);static member Single : seq<'Source> -> 'Source<Extension()>
Public Function Single(Of TSource) (source As IEnumerable(Of TSource)) As TSourceParamètres de type
- TSource
Le type des éléments de source.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> duquel retourner le seul élément.
Retours
Seul élément de la séquence d'entrée.
Exceptions
source a la valeur null.
La séquence d'entrée contient plusieurs éléments.
- ou -
La séquence d'entrée est vide.
Exemples
L’exemple de code suivant montre comment utiliser Single<TSource>(IEnumerable<TSource>) pour sélectionner le seul élément d’un tableau.
string[] fruits1 = { "orange" };
string fruit1 = fruits1.Single();
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.
Dim result As String = fruits1.Single()
' Display the result.
Console.WriteLine($"First query: {result}")
L’exemple de code suivant montre que Single<TSource>(IEnumerable<TSource>) lève une exception lorsque la séquence ne contient pas exactement un élément.
string[] fruits2 = { "orange", "apple" };
string fruit2 = null;
try
{
fruit2 = fruits2.Single();
}
catch (System.InvalidOperationException)
{
Console.WriteLine("The collection does not contain exactly one element.");
}
Console.WriteLine(fruit2);
/*
This code produces the following output:
The collection does not contain exactly one element.
*/
' Create an array that contains two items.
Dim fruits2() As String = {"orange", "apple"}
result = String.Empty
' Try to get the 'single' item in the array.
Try
result = fruits2.Single()
Catch ex As System.InvalidOperationException
result = "The collection does not contain exactly one element."
End Try
' Display the result.
Console.WriteLine($"Second query: {result}")
' This code produces the following output:
'
' First query: orange
' Second query: The collection does not contain exactly one element.
Remarques
La Single<TSource>(IEnumerable<TSource>) méthode lève une exception si la séquence d’entrée est vide. Pour retourner null à la place lorsque la séquence d’entrée est vide, utilisez SingleOrDefault.
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: