Func<T1,T2,TResult> Delegado

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Ensamblado:

System.Core.dll

Ensamblado:

mscorlib.dll

Ensamblado:

netstandard.dll

Encapsula un método que tiene dos parámetros y devuelve un valor del tipo especificado por el parámetro 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);

Parámetros de tipo

T1

Tipo del primer parámetro del método que este delegado encapsula.

Este parámetro de tipo es contravariante, es decir, puede usar el tipo que haya especificado o cualquier tipo menos derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.

T2

Tipo del segundo parámetro del método que este delegado encapsula.

Este parámetro de tipo es contravariante, es decir, puede usar el tipo que haya especificado o cualquier tipo menos derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.

TResult

Tipo del valor devuelto del método que este delegado encapsula.

Este parámetro de tipo es covariante, es decir, puede usar el tipo que haya especificado o cualquier tipo más derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.

Parámetros

arg1

T1

Primer parámetro del método que este delegado encapsula.

arg2

T2

Segundo parámetro del método que este delegado encapsula.

Valor devuelto

TResult

Valor devuelto del método que este delegado encapsula.

Ejemplos

En el ejemplo siguiente se muestra cómo declarar y usar un Func<T1,T2,TResult> delegado. En este ejemplo se declara una Func<T1,T2,TResult> variable y se le asigna una expresión lambda que toma un String valor y un Int32 valor como parámetros. La expresión lambda devuelve true si la longitud del String parámetro es igual al valor del Int32 parámetro . El delegado que encapsula este método se usa posteriormente en una consulta para filtrar cadenas en una matriz de cadenas.

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);
   }
}

Comentarios

Puede usar este delegado para representar un método que se puede pasar como parámetro sin declarar explícitamente un delegado personalizado. El método encapsulado debe corresponder a la firma del método definida por este delegado. Esto significa que el método encapsulado debe tener dos parámetros, cada uno de los cuales se pasa a él por valor y que debe devolver un valor.

Nota

Para hacer referencia a un método que tiene dos parámetros y devuelve void (unit en F#) (o en Visual Basic, que se declara como en Sub lugar de como ), Functionuse el delegado genérico Action<T1,T2> en su lugar.

Cuando se usa el Func<T1,T2,TResult> delegado, no es necesario definir explícitamente un delegado que encapsula un método con dos parámetros. Por ejemplo, el código siguiente declara explícitamente un delegado denominado ExtractMethod y asigna una referencia al ExtractWords método a su instancia de delegado.

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);
   }
}

En el ejemplo siguiente se simplifica este código creando instancias de un Func<T1,T2,TResult> delegado en lugar de definir explícitamente un nuevo delegado y asignarle un método con nombre.

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);
   }
}

Puede usar el Func<T1,T2,TResult> delegado con métodos anónimos en C#, como se muestra en el ejemplo siguiente. (Para obtener una introducción a los métodos anónimos, consulte Métodos anónimos).

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);
   }
}

También puede asignar una expresión lambda a un Func<T1,T2,TResult> delegado, como se muestra en el ejemplo siguiente. (Para obtener una introducción a las expresiones lambda, vea Expresiones lambda (VB), Expresiones lambda (C#) y Expresiones 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);
   }
}

El tipo subyacente de una expresión lambda es uno de los delegados genéricos Func . Esto permite pasar una expresión lambda como un parámetro sin asignarla explícitamente a un delegado. En concreto, dado que muchos métodos de tipos del System.Linq espacio de nombres tienen Func<T1,T2,TResult> parámetros, puede pasar estos métodos a una expresión lambda sin crear instancias explícitas de un Func<T1,T2,TResult> delegado.

Métodos de extensión

GetMethodInfo(Delegate)

Obtiene un objeto que representa el método representado por el delegado especificado.

Se aplica a

Consulte también

• Expresiones lambda (Guía de programación de C#)
• Expresiones lambda: la palabra clave fun (F#)
• Expresiones lambda
• Delegados (Guía de programación de C#)
• Delegados (F#)
• Delegados en Visual Basic