Func<TResult> Func<TResult> Func<TResult> Func<TResult> Delegate

정의

매개 변수가 없고 TResult 매개 변수에 지정된 형식의 값을 반환하는 메서드를 캡슐화합니다.Encapsulates a method that has no parameters and returns a value of the type specified by the TResult parameter.

generic <typename TResult>
public delegate TResult Func();
public delegate TResult Func<out TResult>();
type Func<'Result> = delegate of unit -> 'Result
Public Delegate Function Func(Of Out TResult)() As TResult 

형식 매개 변수

TResult

이 대리자로 캡슐화되는 메서드의 반환 값 형식입니다.The type of the return value of the method that this delegate encapsulates.

반환 값

TResult

이 대리자로 캡슐화되는 메서드의 반환 값입니다.The return value of the method that this delegate encapsulates.

상속
Func<TResult>Func<TResult>Func<TResult>Func<TResult>

예제

다음 예제에서는 매개 변수가 없는 대리자를 사용 하는 방법에 설명 합니다.The following example demonstrates how to use a delegate that takes no parameters. 이 코드 라는 제네릭 클래스를 만듭니다 LazyValue 형식의 필드를 있는 Func<TResult>합니다.This code creates a generic class named LazyValue that has a field of type Func<TResult>. 이 대리자 필드의 형식 매개 변수에 해당 하는 형식의 값을 반환 하는 모든 함수에 대 한 참조를 저장할 수는 LazyValue 개체입니다.This delegate field can store a reference to any function that returns a value of the type that corresponds to the type parameter of the LazyValue object. 합니다 LazyValue 유형 역시는 Value 속성 (이 실행 되지 않았습니다 이미) 하는 경우 함수를 실행 하는 결과 값을 반환 합니다.The LazyValue type also has a Value property that executes the function (if it has not already been executed) and returns the resulting value.

이 예제에서는 두 메서드를 만들고 두 개를 인스턴스화하고 LazyValue 이러한 메서드를 호출 하는 람다 식 사용 하 여 개체입니다.The example creates two methods and instantiates two LazyValue objects with lambda expressions that call these methods. 방금 메서드를 호출 해야 하기 때문에 람다 식 매개 변수를 사용 하지 않습니다.The lambda expressions do not take parameters because they just need to call a method. 두 메서드가 실행 되는 출력에서 알 수 있듯이, 경우에만 각 값 LazyValue 개체가 검색 됩니다.As the output shows, the two methods are executed only when the value of each LazyValue object is retrieved.

using System;

static class Func1
{
   public static void Main()
   {
      // Note that each lambda expression has no parameters.
      LazyValue<int> lazyOne = new LazyValue<int>(() => ExpensiveOne());
      LazyValue<long> lazyTwo = new LazyValue<long>(() => ExpensiveTwo("apple"));

      Console.WriteLine("LazyValue objects have been created.");

      // Get the values of the LazyValue objects.
      Console.WriteLine(lazyOne.Value);
      Console.WriteLine(lazyTwo.Value);
   }
      
   static int ExpensiveOne()
   {
      Console.WriteLine("\nExpensiveOne() is executing.");
      return 1;
   }

   static long ExpensiveTwo(string input)
   {
      Console.WriteLine("\nExpensiveTwo() is executing.");
      return (long)input.Length;
   }
}

class LazyValue<T> where T : struct
{
   private Nullable<T> val;
   private Func<T> getValue;

   // Constructor.
   public LazyValue(Func<T> func)
   {
      val = null;
      getValue = func;
   }

   public T Value
   {
      get
      {
         if (val == null)
            // Execute the delegate.
            val = getValue();
         return (T)val;
      }
   }
}
/* The example produces the following output:

    LazyValue objects have been created.
    
    ExpensiveOne() is executing.
    1
    
    ExpensiveTwo() is executing.
    5
*/    
Public Module Func
   Public Sub Main()
      ' Note that each lambda expression has no parameters.
      Dim lazyOne As New LazyValue(Of Integer)(Function() ExpensiveOne())
      Dim lazyTwo As New LazyValue(Of Long)(Function() ExpensiveTwo("apple")) 

      Console.WriteLine("LazyValue objects have been created.")

      ' Get the values of the LazyValue objects.
      Console.WriteLine(lazyOne.Value)
      Console.WriteLine(lazyTwo.Value)
   End Sub

   Public Function ExpensiveOne() As Integer
      Console.WriteLine()
      Console.WriteLine("ExpensiveOne() is executing.")
      Return 1
   End Function

   Public Function ExpensiveTwo(input As String) As Long
      Console.WriteLine() 
      Console.WriteLine("ExpensiveTwo() is executing.")
      Return input.Length
   End Function
End Module

Public Class LazyValue(Of T As Structure)
   Private val As Nullable(Of T)
   Private getValue As Func(Of T)

   ' Constructor.
   Public Sub New(func As Func(Of T))
      Me.val = Nothing
      Me.getValue = func
   End Sub

   Public ReadOnly Property Value() As T
      Get
         If Me.val Is Nothing Then
            ' Execute the delegate.
            Me.val = Me.getValue()
         End If   
         Return CType(val, T)
      End Get
   End Property
End Class

설명

사용자 지정 대리자를 명시적으로 선언 하지 않고 매개 변수로 전달할 수 있는 메서드를 나타내는이 대리자를 사용할 수 있습니다.You can use this delegate to represent a method that can be passed as a parameter without explicitly declaring a custom delegate. 캡슐화 된 메서드에이 대리자에 의해 정의 되는 메서드 시그니처와 일치 해야 합니다.The encapsulated method must correspond to the method signature that is defined by this delegate. 즉, 캡슐화 된 메서드에 매개 변수가 없어야 하는 값을 반환 해야 합니다.This means that the encapsulated method must have no parameters and must return a value.

참고

매개 변수가 없으며 반환 하는 메서드를 참조 void (Visual Basic의 경우로 선언 되는 Sub 아니라는 Function)를 사용 하 여는 Action 대리자를 대신 합니다.To reference a method that has no parameters and returns void (or in Visual Basic, that is declared as a Sub rather than as a Function), use the Action delegate instead.

사용 하는 경우는 Func<TResult> 대리자 필요가 없습니다를 명시적으로 매개 변수가 없는 메서드를 캡슐화 하는 대리자를 정의 합니다.When you use the Func<TResult> delegate, you do not have to explicitly define a delegate that encapsulates a parameterless method. 예를 들어, 다음 코드는 라는 대리자를 명시적으로 선언 WriteMethod 에 대 한 참조를 할당 합니다 OutputTarget.SendToFile 메서드 대리자 인스턴스를 인스턴스.For example, the following code explicitly declares a delegate named WriteMethod and assigns a reference to the OutputTarget.SendToFile instance method to its delegate instance.

using System;
using System.IO;

delegate bool WriteMethod();

public class TestDelegate
{
   public static void Main()
   {
      OutputTarget output = new OutputTarget();
      WriteMethod methodCall = output.SendToFile;
      if (methodCall())
         Console.WriteLine("Success!"); 
      else
         Console.WriteLine("File write operation failed.");
   }
}

public class OutputTarget
{
   public bool SendToFile()
   {
      try
      {
         string fn = Path.GetTempFileName();
         StreamWriter sw = new StreamWriter(fn);
         sw.WriteLine("Hello, World!");
         sw.Close();
         return true;
      }  
      catch
      {
         return false;
      }
   }
}
Imports System.IO

Delegate Function WriteMethod As Boolean

Module TestDelegate
   Public Sub Main()
      Dim output As New OutputTarget()
      Dim methodCall As WriteMethod = AddressOf output.SendToFile
      If methodCall() Then 
         Console.WriteLine("Success!")
      Else
         Console.WriteLine("File write operation failed.")
      End If      
   End Sub
End Module

Public Class OutputTarget
   Public Function SendToFile() As Boolean
      Try
         Dim fn As String = Path.GetTempFileName
         Dim sw As StreamWriter = New StreamWriter(fn)
         sw.WriteLine("Hello, World!")
         sw.Close      
         Return True
      Catch
         Return False
      End Try
   End Function
End Class

다음 예제에서는 인스턴스화하여이 코드를 간소화는 Func<TResult> 명시적으로 새 대리자를 정의 하 고 명명된 된 메서드를 할당 하는 대신 대리자입니다.The following example simplifies this code by instantiating the Func<TResult> delegate instead of explicitly defining a new delegate and assigning a named method to it.

using System;
using System.IO;

public class TestDelegate
{
   public static void Main()
   {
      OutputTarget output = new OutputTarget();
      Func<bool> methodCall = output.SendToFile;
      if (methodCall())
         Console.WriteLine("Success!"); 
      else
         Console.WriteLine("File write operation failed.");
   }
}

public class OutputTarget
{
   public bool SendToFile()
   {
      try
      {
         string fn = Path.GetTempFileName();
         StreamWriter sw = new StreamWriter(fn);
         sw.WriteLine("Hello, World!");
         sw.Close();
         return true;
      }  
      catch
      {
         return false;
      }
   }
}
Imports System.IO

Module TestDelegate
   Public Sub Main()
      Dim output As New OutputTarget()
      Dim methodCall As Func(Of Boolean) = AddressOf output.SendToFile
      If methodCall() Then 
         Console.WriteLine("Success!")
      Else
         Console.WriteLine("File write operation failed.")
      End If      
   End Sub
End Module

Public Class OutputTarget
   Public Function SendToFile() As Boolean
      Try
         Dim fn As String = Path.GetTempFileName
         Dim sw As StreamWriter = New StreamWriter(fn)
         sw.WriteLine("Hello, World!")
         sw.Close      
         Return True
      Catch
         Return False
      End Try
   End Function
End Class

사용할 수는 Func<TResult> 다음 예제와 같이 C#에서는 무명 메서드로 위임 합니다.You can use the Func<TResult> delegate with anonymous methods in C#, as the following example illustrates. (소개 무명 메서드를 참조 하세요 무명 메서드.)(For an introduction to anonymous methods, see Anonymous Methods.)

using System;
using System.IO;

public class Anonymous
{
   public static void Main()
   {
      OutputTarget output = new OutputTarget();
      Func<bool> methodCall = delegate() { return output.SendToFile(); };
      if (methodCall())
         Console.WriteLine("Success!"); 
      else
         Console.WriteLine("File write operation failed.");
   }
}

public class OutputTarget
{
   public bool SendToFile()
   {
      try
      {
         string fn = Path.GetTempFileName();
         StreamWriter sw = new StreamWriter(fn);
         sw.WriteLine("Hello, World!");
         sw.Close();
         return true;
      }  
      catch
      {
         return false;
      }
   }
}

람다 식을 할당할 수도 있습니다는 Func<T,TResult> 다음 예제와 같이 대리자입니다.You can also assign a lambda expression to a Func<T,TResult> delegate, as the following example illustrates. (람다 식에 대 한 소개를 참조 하세요 람다 식 하 고 람다 식.)(For an introduction to lambda expressions, see Lambda Expressions and Lambda Expressions.)

using System;
using System.IO;

public class Anonymous
{
   public static void Main()
   {
      OutputTarget output = new OutputTarget();
      Func<bool> methodCall = () => output.SendToFile(); 
      if (methodCall())
         Console.WriteLine("Success!"); 
      else
         Console.WriteLine("File write operation failed.");
   }
}

public class OutputTarget
{
   public bool SendToFile()
   {
      try
      {
         string fn = Path.GetTempFileName();
         StreamWriter sw = new StreamWriter(fn);
         sw.WriteLine("Hello, World!");
         sw.Close();
         return true;
      }  
      catch
      {
         return false;
      }
   }
}
Imports System.IO

Module TestDelegate
   Public Sub Main()
      Dim output As New OutputTarget()
      Dim methodCall As Func(Of Boolean) = Function() output.SendToFile()
      If methodCall() Then 
         Console.WriteLine("Success!")
      Else
         Console.WriteLine("File write operation failed.")
      End If      
   End Sub
End Module

Public Class OutputTarget
   Public Function SendToFile() As Boolean
      Try
         Dim fn As String = Path.GetTempFileName
         Dim sw As StreamWriter = New StreamWriter(fn)
         sw.WriteLine("Hello, World!")
         sw.Close      
         Return True
      Catch
         Return False
      End Try
   End Function
End Class

람다 식의 기본 형식이 제네릭 중 하나인 Func 대리자입니다.The underlying type of a lambda expression is one of the generic Func delegates. 이 대리자를 명시적으로 할당 하지 않고 람다 식을 매개 변수로 전달할 수 있습니다.This makes it possible to pass a lambda expression as a parameter without explicitly assigning it to a delegate. 특히 때문에 형식의 여러 메서드를 System.Linq 네임 스페이스 Func 매개 변수를 하면 이러한 메서드는 람다 식을 전달할 수 명시적으로 인스턴스화하지 않고도 Func 위임 합니다.In particular, because many methods of types in the System.Linq namespace have Func parameters, you can pass these methods a lambda expression without explicitly instantiating a Func delegate.

비용이 많이 드는 계산 결과 실제로 필요한 경우에 실행 하려는 경우에 비용이 많이 드는 함수를 할당할 수 있습니다는 Func<TResult> 위임 합니다.If you have an expensive computation that you want to execute only if the result is actually needed, you can assign the expensive function to a Func<TResult> delegate. 값에 액세스 하는 속성 식에서 사용 될 때까지 함수 실행을 지연할 수 있습니다.The execution of the function can then be delayed until a property that accesses the value is used in an expression. 다음 섹션의 예제에서는이 작업을 수행 하는 방법에 설명 합니다.The example in the next section demonstrates how to do this.

확장 메서드

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate)

지정된 대리자가 나타내는 메서드를 나타내는 개체를 가져옵니다.Gets an object that represents the method represented by the specified delegate.

적용 대상

추가 정보