Func<T1,T2,TResult> 代理人

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

アセンブリ:

System.Core.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

2 個のパラメーターを持ち、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);

型パラメーター

T1

このデリゲートによってカプセル化されるメソッドの最初のパラメーターの型。

この型パラメーターは反変です。 つまり、指定した型、または弱い派生型のいずれかを使用することができます。 共変性および反変性の詳細については、「ジェネリックの共変性と反変性」をご覧ください。

T2

このデリゲートによってカプセル化されるメソッドの 2 番目のパラメーターの型。

この型パラメーターは反変です。 つまり、指定した型、または弱い派生型のいずれかを使用することができます。 共変性および反変性の詳細については、「ジェネリックの共変性と反変性」をご覧ください。

TResult

このデリゲートによってカプセル化されるメソッドの戻り値の型。

この型パラメーターは共変です。 つまり、指定した型、または強い派生型のいずれかを使用することができます。 共変性および反変性の詳細については、「ジェネリックの共変性と反変性」をご覧ください。

パラメーター

arg1

T1

このデリゲートによってカプセル化されるメソッドの最初のパラメーター。

arg2

T2

このデリゲートによってカプセル化されるメソッドの 2 番目のパラメーター。

戻り値

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

注釈

このデリゲートを使用すると、カスタム デリゲートを明示的に宣言せずにパラメーターとして渡すことができるメソッドを表すことができます。 カプセル化されたメソッドは、このデリゲートによって定義されるメソッド シグネチャに対応している必要があります。 つまり、カプセル化されたメソッドには 2 つのパラメーターが必要であり、それぞれが値によって渡され、値を返す必要があります。

注意

2 つのパラメーターを持ち、void(F# では) (unitまたは Visual Basicでは、代わりにジェネリック デリゲートとしてSub宣言されている) メソッドをFunction参照するには、代わりにジェネリック Action<T1,T2> デリゲートを使用します。

デリゲートを Func<T1,T2,TResult> 使用する場合は、2 つのパラメーターを持つメソッドをカプセル化するデリゲートを明示的に定義する必要はありません。 たとえば、次のコードでは、名前付きの ExtractMethod デリゲートを明示的に宣言し、そのデリゲート インスタンスにメソッドへの ExtractWords 参照を割り当てます。

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

次の例では、新しいデリゲートを明示的に定義して名前付きメソッドを Func<T1,T2,TResult> 割り当てるのではなく、デリゲートをインスタンス化することで、このコードを簡略化します。

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

次の例に Func<T1,T2,TResult> 示すように、C# の匿名メソッドでデリゲートを使用できます。 (匿名メソッドの概要については、 匿名メソッドを参照してください)。

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

次の例に示すように、ラムダ式をデリゲートに Func<T1,T2,TResult> 割り当てることもできます。 (ラムダ式の概要については、「ラムダ式 (VB)、ラムダ式 (C#)、ラムダ式 (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);
   }
}

ラムダ式の基になる型は、ジェネリック Func デリゲートの 1 つです。 これにより、ラムダ式を明示的にデリゲートに割り当てることなく、パラメーターとして渡すことができます。 特に、名前空間内 System.Linq の型の多くのメソッドには Func<T1,T2,TResult> パラメーターがあるため、デリゲートを明示的にインスタンス化せずにラムダ式をこれらのメソッドに Func<T1,T2,TResult> 渡すことができます。

拡張メソッド

GetMethodInfo(Delegate)

指定したデリゲートによって表されるメソッドを表すオブジェクトを取得します。

適用対象

こちらもご覧ください

• ラムダ式 (C# プログラミング ガイド)
• ラムダ式: fun キーワード (F#)
• ラムダ式
• デリゲート (C# プログラミング ガイド)
• デリゲート (F#)
• Visual Basicのデリゲート