Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Queryable.First<TSource>, méthode (IQueryable<TSource>, Expression<Func<TSource, Boolean>>)

Retourne le premier élément d'une séquence qui satisfait à la condition spécifiée.

Espace de noms :  System.Linq
Assembly :  System.Core (dans System.Core.dll)

public static TSource First<TSource>(
	this IQueryable<TSource> source,
	Expression<Func<TSource, bool>> predicate
)

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
Type : System.Linq.IQueryable<TSource>
IQueryable<T> à partir duquel retourner un élément.
predicate
Type : System.Linq.Expressions.Expression<Func<TSource, Boolean>>
Fonction permettant de tester chaque élément par rapport à une condition.

Valeur de retour

Type : TSource
Premier élément de source qui réussit le test dans predicate.

Remarque sur l'utilisation

En Visual Basic et C#, vous pouvez appeler cette méthode comme une méthode d'instance sur n'importe quel objet de type IQueryable<TSource>. Lorsque vous utilisez la syntaxe des méthodes d'instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d'informations, consultez Méthodes d'extension (Visual Basic) ou Méthodes d'extension (Guide de programmation C#).

ExceptionCondition
ArgumentNullException

source ou predicate est null.

InvalidOperationException

Aucun élément ne satisfait à la condition dans predicate.

ou

La séquence source est vide.

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l'argument de type est l'un des types Func<T, TResult>. Pour ces paramètres, vous pouvez les passer dans une expression lambda et elle sera compilée en une Expression<TDelegate>.

La méthode First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) génère une MethodCallExpression qui représente l'appel de First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) à lui-même en tant que méthode générique construite. Il passe alors la MethodCallExpression à la méthode Execute<TResult>(Expression) du IQueryProvider représenté par la propriété Provider du paramètre source.

Le comportement de requête résultant de l'exécution d'une arborescence de l'expression qui représente l'appel de First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) dépend de l'implémentation du type du paramètre source. Le comportement attendu est qu'il retourne le premier élément dans source qui satisfait à la condition spécifiée par predicate.

L'exemple de code suivant montre comment utiliser First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) pour retourner le premier élément d'une séquence qui satisfait à une condition.


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

            // Get the first number in the array that is greater than 80.
            int first = numbers.AsQueryable().First(number => number > 80);

            Console.WriteLine(first);

            /*
                This code produces the following output:

                92
            */



.NET Framework

Pris en charge dans : 4, 3.5

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Pris en charge dans :

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft