Func<T1,T2,T3,TResult> Делегат

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Сборка:

System.Core.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

Инкапсулирует метод, который имеет три параметра и возвращает значение типа, указанного параметром 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);

Параметры типа

T1

Тип первого параметра метода, инкапсулируемого данным делегатом.

Это контравариантный параметр типа. Это означает, что вы можете использовать любой из указанных типов или любой тип, являющийся менее производным. Дополнительные сведения о ковариантности и контрвариантности см. в статье Ковариантность и контрвариантность в универсальных шаблонах.

T2

Тип второго параметра метода, инкапсулируемого этим делегатом.

Это контравариантный параметр типа. Это означает, что вы можете использовать любой из указанных типов или любой тип, являющийся менее производным. Дополнительные сведения о ковариантности и контрвариантности см. в статье Ковариантность и контрвариантность в универсальных шаблонах.

T3

Тип третьего параметра метода, инкапсулируемого этим делегатом.

Это контравариантный параметр типа. Это означает, что вы можете использовать любой из указанных типов или любой тип, являющийся менее производным. Дополнительные сведения о ковариантности и контрвариантности см. в статье Ковариантность и контрвариантность в универсальных шаблонах.

TResult

Тип возвращаемого значения метода, инкапсулируемого данным делегатом.

Это ковариантный параметр типа. Это означает, что вы можете использовать любой из указанных типов или любой тип, являющийся более производным. Дополнительные сведения о ковариантности и контрвариантности см. в статье Ковариантность и контрвариантность в универсальных шаблонах.

Параметры

arg1

T1

Первый параметр метода, инкапсулируемого данным делегатом.

arg2

T2

Второй параметр метода, инкапсулируемого данным делегатом.

arg3

T3

Третий параметр метода, инкапсулируемого данным делегатом.

Возвращаемое значение

TResult

Возвращаемое значение метода, инкапсулируемого данным делегатом.

Примеры

В следующем примере показано, как объявить и использовать Func<T1,T2,TResult> делегат. В этом примере объявляется Func<T1,T2,TResult> переменная и назначается лямбда-выражение, которое принимает String значение и Int32 значение в качестве параметров. Лямбда-выражение возвращается true , если длина String параметра равна значению Int32 параметра. Делегат, инкапсулирующий этот метод, впоследствии используется в запросе для фильтрации строк в массиве строк.

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

Комментарии

Этот делегат можно использовать для представления метода, который можно передать в качестве параметра без явного объявления пользовательского делегата. Инкапсулированный метод должен соответствовать сигнатуре метода, определенной этим делегатом. Это означает, что инкапсулированный метод должен иметь три параметра, каждый из которых передается в него по значению, и что он должен возвращать значение.

Примечание

Чтобы ссылаться на метод, имеющий три параметра и возвращаемые void значения (unitв F#) (или в Visual Basic, который объявляется как не Sub в качестве), используйте вместо него универсальный FunctionAction<T1,T2,T3> делегат.

При использовании делегата Func<T1,T2,T3,TResult> не нужно явно определять делегат, инкапсулирующий метод с тремя параметрами. Например, следующий код явно объявляет универсальный делегат с именем ParseNumber и назначает ссылку на метод его экземпляру делегата Parse .

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

В следующем примере этот код упрощается путем создания Func<T1,T2,T3,TResult> экземпляра делегата вместо явного определения нового делегата и назначения именованного метода ему.

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

Делегат можно использовать Func<T1,T2,T3,TResult> с анонимными методами в C#, как показано в следующем примере. (Общие сведения об анонимных методах см. в разделе "Анонимные методы".)

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

Можно также назначить лямбда-выражение делегату Func<T1,T2,T3,TResult> , как показано в следующем примере. (Общие сведения о лямбда-выражениях см. в лямбда-выражениях (VB), лямбда-выражениях (C#) и лямбда-выражениях (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));
   }
}

Базовый тип лямбда-выражения является одним из универсальных Func делегатов. Это позволяет передать лямбда-выражение в качестве параметра без явного назначения его делегату. В частности, поскольку многие методы типов в System.Linq пространстве имен имеют Func параметры, эти методы можно передать лямбда-выражение без явного создания экземпляра делегата Func .

Методы расширения

GetMethodInfo(Delegate)

Получает объект, представляющий метод, представленный указанным делегатом.

Применяется к

См. также раздел

• Лямбда-выражения (Руководство по программированию в C#)
• Лямбда-выражения
• Лямбда-выражения: ключевое слово fun (F#)
• Делегаты (Руководство по программированию на C#)
• Делегаты (F#)
• Делегаты в Visual Basic