Func<T1,T2,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 à deux paramètres et retourne une valeur du type spécifié par le paramètre TResult.

C#

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

C#

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

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.

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é.

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 lui assigne 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 passée 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 deux paramètres, chacun d’eux étant transmis par valeur, et qu’il doit retourner une valeur.

Note

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

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

C#

using System;

delegate string[] ExtractMethod(string stringToManipulate, int maximum);

public class DelegateExample
{
   public static void Main()
   {
      // Instantiate delegate to reference ExtractWords method
      ExtractMethod extractMeth = ExtractWords;
      string title = "The Scarlet Letter";
      // Use delegate instance to call ExtractWords method and display result
      foreach (string word in extractMeth(title, 5))
         Console.WriteLine(word);
   }

   private static string[] ExtractWords(string phrase, int limit)
   {
      char[] delimiters = new char[] {' '};
      if (limit > 0)
         return phrase.Split(delimiters, limit);
      else
         return phrase.Split(delimiters);
   }
}

L’exemple suivant simplifie ce code en instanciant un Func<T1,T2,TResult> délégué au lieu de définir explicitement un nouveau délégué et en lui affectant une méthode nommée.

C#

using System;

public class GenericFunc
{
   public static void Main()
   {
      // Instantiate delegate to reference ExtractWords method
      Func<string, int, string[]> extractMethod = ExtractWords;
      string title = "The Scarlet Letter";
      // Use delegate instance to call ExtractWords method and display result
      foreach (string word in extractMethod(title, 5))
         Console.WriteLine(word);
   }

   private static string[] ExtractWords(string phrase, int limit)
   {
      char[] delimiters = new char[] {' '};
      if (limit > 0)
         return phrase.Split(delimiters, limit);
      else
         return phrase.Split(delimiters);
   }
}

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

C#

using System;

public class Anonymous
{
   public static void Main()
   {
      Func<string, int, string[]> extractMeth = delegate(string s, int i)
         { char[] delimiters = new char[] {' '};
           return i > 0 ? s.Split(delimiters, i) : s.Split(delimiters);
         };

      string title = "The Scarlet Letter";
      // Use Func instance to call ExtractWords method and display result
      foreach (string word in extractMeth(title, 5))
         Console.WriteLine(word);
   }
}

Vous pouvez également affecter une expression lambda à un Func<T1,T2,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;

public class LambdaExpression
{
   public static void Main()
   {
      char[] separators = new char[] {' '};
      Func<string, int, string[]> extract = (s, i) =>
           i > 0 ? s.Split(separators, i) : s.Split(separators) ;

      string title = "The Scarlet Letter";
      // Use Func instance to call ExtractWords method and display result
      foreach (string word in extract(title, 5))
         Console.WriteLine(word);
   }
}

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 dans l’espace System.Linq de noms ont Func<T1,T2,TResult> des paramètres, vous pouvez passer ces méthodes une expression lambda sans instancier explicitement un Func<T1,T2,TResult> 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 : mot clé fun (F#)
• Expressions lambda
• Délégués (Guide de programmation C#)
• Délégués (F#)
• Délégués dans Visual Basic