Číst v angličtině

Sdílet prostřednictvím

Func<T1,T2,TResult> Delegát

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
System.Core.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll

Zapouzdří metodu, která má dva parametry, a vrátí hodnotu typu určeného parametrem TResult .

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

Parametry typu

T1

Typ prvního parametru metody, který tento delegát zapouzdřuje.

Tento parametr typu je kontravariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je méně odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.
T2

Typ druhého parametru metody, který tento delegát zapouzdřuje.

Tento parametr typu je kontravariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je méně odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.
TResult

Typ návratové hodnoty metody, kterou tento delegát zapouzdřuje.

Tento parametr typu je kovariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je více odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.

Parametry

arg1
T1

První parametr metody, kterou tento delegát zapouzdřuje.

arg2
T2

Druhý parametr metody, kterou tento delegát zapouzdřuje.

Návratová hodnota

TResult

Návratová hodnota metody, kterou tento delegát zapouzdřuje.

Příklady

Následující příklad ukazuje, jak deklarovat a používat delegáta Func<T1,T2,TResult> . Tento příklad deklaruje proměnnou Func<T1,T2,TResult> a přiřadí ji výraz lambda, který přebírá String hodnotu a Int32 hodnotu jako parametry. Výraz lambda vrátí true , pokud je délka String parametru rovna hodnotě parametru Int32 . Delegát, který zapouzdřuje tuto metodu, se následně používá v dotazu k filtrování řetězců v poli řetězců.

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

Poznámky

Tento delegát můžete použít k reprezentaci metody, která se dá předat jako parametr, aniž byste explicitně deklarovali vlastního delegáta. Zapouzdřená metoda musí odpovídat podpisu metody definované tímto delegátem. To znamená, že zapouzdřená metoda musí mít dva parametry, z nichž každá je předána hodnotou a že musí vrátit hodnotu.

Poznámka

Chcete-li odkazovat na metodu, která má dva parametry a vrací void (unitv jazyce F#) (nebo v Visual Basic, která je deklarována jako Sub místo jako ), Functionpoužijte místo toho obecný Action<T1,T2> delegát.

Když použijete Func<T1,T2,TResult> delegáta, nemusíte explicitně definovat delegáta, který zapouzdřuje metodu se dvěma parametry. Například následující kód explicitně deklaruje delegáta pojmenovaný ExtractMethod a přiřadí odkaz na metodu ExtractWords k jeho instanci delegáta.

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

Následující příklad tento kód zjednodušuje vytvořením instance delegáta Func<T1,T2,TResult> místo explicitního definování nového delegáta a přiřazením pojmenované metody k němu.

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

Delegáta můžete použít Func<T1,T2,TResult> s anonymními metodami v jazyce C#, jak je znázorněno v následujícím příkladu. (Úvod k anonymním metodám naleznete v tématu Anonymní metody.)

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

Výraz lambda můžete také přiřadit delegátu Func<T1,T2,TResult> , jak je znázorněno v následujícím příkladu. (Úvod k výrazům lambda najdete v tématu Výrazy lambda (VB), výrazy lambda (C#) a výrazy lambda (F#).)

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

Základní typ výrazu lambda je jedním z obecných Func delegátů. To umožňuje předat výraz lambda jako parametr, aniž byste ho explicitně přiřadili delegátu. Zejména proto, že mnoho metod typů v System.Linq oboru názvů má Func<T1,T2,TResult> parametry, můžete tyto metody předat výraz lambda, aniž byste explicitně vytvořili instanci delegáta Func<T1,T2,TResult> .

Metody rozšíření

GetMethodInfo(Delegate)

Získá objekt, který představuje metodu reprezentovanou zadaným delegátem.

Platí pro

Viz také