Func<T1,T2,T3,TResult> Délégué

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

System.Core.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Encapsule une méthode qui a trois paramètres et qui retourne une valeur du type spécifié par le paramètre TResult.

C#

public delegate TResult Func<in T1,in T2,in T3,out TResult>(T1 arg1, T2 arg2, T3 arg3);

C#

public delegate TResult Func<T1,T2,T3,TResult>(T1 arg1, T2 arg2, T3 arg3);

Paramètres de type

T1

Type du premier paramètre de la méthode encapsulée par ce délégué.

Ce paramètre de type est contravariant. Cela signifie que vous pouvez utiliser le type spécifié ou tout type moins dérivé. Pour plus d’informations sur la covariance et la contravariance, consultez Covariance et contravariance dans les génériques.

T2

Type du deuxième paramètre de la méthode encapsulée par ce délégué.

Ce paramètre de type est contravariant. Cela signifie que vous pouvez utiliser le type spécifié ou tout type moins dérivé. Pour plus d’informations sur la covariance et la contravariance, consultez Covariance et contravariance dans les génériques.

T3

Type du troisième paramètre de la méthode encapsulée par ce délégué.

Ce paramètre de type est contravariant. Cela signifie que vous pouvez utiliser le type spécifié ou tout type moins dérivé. Pour plus d’informations sur la covariance et la contravariance, consultez Covariance et contravariance dans les génériques.

TResult

Type de la valeur de retour de la méthode encapsulée par ce délégué.

Ce paramètre de type est covariant. Cela signifie que vous pouvez utiliser le type spécifié ou tout type plus dérivé. Pour plus d’informations sur la covariance et la contravariance, consultez Covariance et contravariance dans les génériques.

Paramètres

arg1

T1

Premier paramètre de la méthode encapsulée par ce délégué.

arg2

T2

Deuxième paramètre de la méthode encapsulée par ce délégué.

arg3

T3

Troisième paramètre de la méthode encapsulée par ce délégué.

Valeur renvoyée

TResult

Valeur de retour de la méthode encapsulée par ce délégué.

Exemples

L’exemple suivant montre comment déclarer et utiliser un Func<T1,T2,TResult> délégué. Cet exemple déclare une Func<T1,T2,TResult> variable et l’affecte à une expression lambda qui prend une String valeur et une Int32 valeur en tant que paramètres. L’expression lambda retourne true si la longueur du String paramètre est égale à la valeur du Int32 paramètre. Le délégué qui encapsule cette méthode est ensuite utilisé dans une requête pour filtrer les chaînes dans un tableau de chaînes.

C#

using System;
using System.Collections.Generic;
using System.Linq;

public class Func3Example
{
   public static void Main()
   {
      Func<String, int, bool> predicate = (str, index) => str.Length == index;

      String[] words = { "orange", "apple", "Article", "elephant", "star", "and" };
      IEnumerable<String> aWords = words.Where(predicate).Select(str => str);

      foreach (String word in aWords)
         Console.WriteLine(word);
   }
}

Remarques

Vous pouvez utiliser ce délégué pour représenter une méthode qui peut être transmise en tant que paramètre sans déclarer explicitement un délégué personnalisé. La méthode encapsulée doit correspondre à la signature de méthode définie par ce délégué. Cela signifie que la méthode encapsulée doit avoir trois paramètres, dont chacun est transmis par valeur, et qu’il doit retourner une valeur.

Notes

Pour référencer une méthode qui a trois paramètres et retourne void (uniten F#) (ou dans Visual Basic, qui est déclarée comme un Sub plutôt que comme un Function), utilisez plutôt le délégué générique Action<T1,T2,T3> à la place.

Lorsque vous utilisez le Func<T1,T2,T3,TResult> délégué, vous n’avez pas besoin de définir explicitement un délégué qui encapsule une méthode avec trois paramètres. Par exemple, le code suivant déclare explicitement un délégué générique nommé ParseNumber et affecte une référence à la Parse méthode à son instance de délégué.

C#

using System;
using System.Globalization;

delegate T ParseNumber<T>(string input, NumberStyles styles,
                         IFormatProvider provider);

public class DelegateExample
{
   public static void Main()
   {
      string numericString = "-1,234";
      ParseNumber<int> parser = int.Parse;
      Console.WriteLine(parser(numericString,
                        NumberStyles.Integer | NumberStyles.AllowThousands,
                        CultureInfo.InvariantCulture));
   }
}

L’exemple suivant simplifie ce code en instanciant le Func<T1,T2,T3,TResult> délégué au lieu de définir explicitement un nouveau délégué et d’affecter une méthode nommée à celle-ci.

C#

using System;
using System.Globalization;

public class GenericFunc
{
   public static void Main()
   {
      string numericString = "-1,234";
      Func<string, NumberStyles, IFormatProvider, int> parser = int.Parse;
      Console.WriteLine(parser(numericString,
                        NumberStyles.Integer | NumberStyles.AllowThousands,
                        CultureInfo.InvariantCulture));
   }
}

Vous pouvez utiliser le délégué avec des méthodes anonymes en C#, comme l’illustre l’exemple Func<T1,T2,T3,TResult> suivant. (Pour une présentation des méthodes anonymes, consultez Méthodes anonymes.)

C#

using System;
using System.Globalization;

public class Anonymous
{
   public static void Main()
   {
      string numericString = "-1,234";
      Func<string, NumberStyles, IFormatProvider, int> parser =
           delegate(string s, NumberStyles sty, IFormatProvider p)
           { return int.Parse(s, sty, p); };
      Console.WriteLine(parser(numericString,
                        NumberStyles.Integer | NumberStyles.AllowThousands,
                        CultureInfo.InvariantCulture));
   }
}

Vous pouvez également affecter une expression lambda à un Func<T1,T2,T3,TResult> délégué, comme l’illustre l’exemple suivant. (Pour une introduction aux expressions lambda, consultez Expressions lambda (VB), Expressions lambda (C#) et Expressions lambda (F#).)

C#

using System;
using System.Globalization;

public class LambdaExpression
{
   public static void Main()
   {
      string numericString = "-1,234";
      Func<string, NumberStyles, IFormatProvider, int> parser = (s, sty, p)
                   => int.Parse(s, sty, p);
      Console.WriteLine(parser(numericString,
                        NumberStyles.Integer | NumberStyles.AllowThousands,
                        CultureInfo.InvariantCulture));
   }
}

Le type sous-jacent d’une expression lambda est l’un des délégués génériques Func . Cela permet de passer une expression lambda en tant que paramètre sans l’affecter explicitement à un délégué. En particulier, étant donné que de nombreuses méthodes de types de l’espace System.Linq de noms ont Func des paramètres, vous pouvez passer ces méthodes une expression lambda sans instancier explicitement un Func délégué.

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.

S’applique à

Voir aussi

• Expressions lambda (Guide de programmation C#)
• Expressions lambda
• Expressions lambda : mot clé fun (F#)
• Délégués (Guide de programmation C#)
• Délégués (F#)
• Délégués dans Visual Basic