Func<T,TResult> Func<T,TResult> Func<T,TResult> Func<T,TResult> Delegate

Definition

Kapselt eine Methode, die über einen Parameter verfügt und einen Wert von dem Typ zurückgibt, der vom TResult-Parameter angegeben wird. Encapsulates a method that has one parameter and returns a value of the type specified by the TResult parameter.

generic <typename T, typename TResult>
public delegate TResult Func(T arg);
public delegate TResult Func<in T,out TResult>(T arg);
type Func<'T, 'Result> = delegate of 'T -> 'Result
Public Delegate Function Func(Of In T, Out TResult)(arg As T) As TResult 
Typparameter
T

Der Typ des Parameters der Methode, die dieser Delegat kapselt. The type of the parameter of the method that this delegate encapsulates.

TResult

Der Typ des Rückgabewerts der Methode, die dieser Delegat kapselt. The type of the return value of the method that this delegate encapsulates.

Parameter
arg

Der Parameter der Methode, die dieser Delegat kapselt. The parameter of the method that this delegate encapsulates.

Rückgabewert
TResult

Der Rückgabewert der Methode, die dieser Delegat kapselt. The return value of the method that this delegate encapsulates.

Vererbung
Func<T,TResult>Func<T,TResult>Func<T,TResult>Func<T,TResult>

Beispiele

Im folgende Beispiel wird veranschaulicht, wie deklariert und verwendet eine Func<T,TResult> delegieren.The following example demonstrates how to declare and use a Func<T,TResult> delegate. Das folgende Beispiel deklariert eine Func<T,TResult> Variable und weist ihr einen Lambda-Ausdruck, der die Zeichen in einer Zeichenfolge in Großbuchstaben konvertiert.This example declares a Func<T,TResult> variable and assigns it a lambda expression that converts the characters in a string to uppercase. Der Delegat, der diese Methode kapselt wird anschließend zum Übergeben der Enumerable.Select Methode, um die Zeichenfolgen in ein Array von Zeichenfolgen in Großbuchstaben zu ändern.The delegate that encapsulates this method is subsequently passed to the Enumerable.Select method to change the strings in an array of strings to uppercase.

using System;
using System.Collections;
using System.Collections.Generic;
using System.Linq;

static class Func
{
   static void Main(string[] args)
   {
      // Declare a Func variable and assign a lambda expression to the  
      // variable. The method takes a string and converts it to uppercase.
      Func<string, string> selector = str => str.ToUpper();
   
      // Create an array of strings.
      string[] words = { "orange", "apple", "Article", "elephant" };
      // Query the array and select strings according to the selector method.
      IEnumerable<String> aWords = words.Select(selector);
   
      // Output the results to the console.
      foreach (String word in aWords)
         Console.WriteLine(word);
   }
}      
/*
This code example produces the following output:
            
   ORANGE
   APPLE
   ARTICLE
   ELEPHANT
*/
Imports System.Collections.Generic
Imports System.Linq

Module Func
   Public Sub Main()
      ' Declare a Func variable and assign a lambda expression to the  
      ' variable. The method takes a string and converts it to uppercase.
      Dim selector As Func(Of String, String) = Function(str) str.ToUpper()
   
      ' Create an array of strings.
      Dim words() As String = { "orange", "apple", "Article", "elephant" }
      ' Query the array and select strings according to the selector method.
      Dim aWords As IEnumerable(Of String) = words.Select(selector)
   
      ' Output the results to the console.
      For Each word As String In aWords
         Console.WriteLine(word)
      Next
   End Sub
End Module
' This code example produces the following output:
'           
'   ORANGE
'   APPLE
'   ARTICLE
'   ELEPHANT

Hinweise

Sie können diesen Delegaten verwenden, um eine Methode darstellen, die als Parameter übergeben werden können, ohne explizit einen benutzerdefinierten Delegaten zu deklarieren.You can use this delegate to represent a method that can be passed as a parameter without explicitly declaring a custom delegate. Die der gekapselte Methode muss die Signatur der Methode entsprechen, die von diesem Delegaten definiert ist.The encapsulated method must correspond to the method signature that is defined by this delegate. Dies bedeutet, dass die gekapselte Methode einen Parameter verfügen muss, das zuvor als Wert übergeben wird, und sie einen Wert zurückgeben muss.This means that the encapsulated method must have one parameter that is passed to it by value, and that it must return a value.

Hinweis

Um eine Methode zu verweisen, die über einen Parameter verfügt und zurückgibt void (oder in Visual Basic deklariert wird als eine Sub statt als ein Function), die generische Action<T> stattdessen delegieren.To reference a method that has one parameter and returns void (or in Visual Basic, that is declared as a Sub rather than as a Function), use the generic Action<T> delegate instead.

Bei Verwendung der Func<T,TResult> Delegaten, Sie müssen nicht explizit einen Delegaten definieren, die eine Methode mit einem einzigen Parameter kapselt.When you use the Func<T,TResult> delegate, you do not have to explicitly define a delegate that encapsulates a method with a single parameter. Der folgende Code deklariert beispielsweise explizit einen Delegaten, der mit dem Namen ConvertMethod und weist einen Verweis auf die UppercaseString Methode, um eine Delegatinstanz.For example, the following code explicitly declares a delegate named ConvertMethod and assigns a reference to the UppercaseString method to its delegate instance.

using System;

delegate string ConvertMethod(string inString);

public class DelegateExample
{
   public static void Main()
   {
      // Instantiate delegate to reference UppercaseString method
      ConvertMethod convertMeth = UppercaseString;
      string name = "Dakota";
      // Use delegate instance to call UppercaseString method
      Console.WriteLine(convertMeth(name));
   }

   private static string UppercaseString(string inputString)
   {
      return inputString.ToUpper();
   }
}
' Declare a delegate to represent string conversion method
Delegate Function ConvertMethod(ByVal inString As String) As String

Module DelegateExample
   Public Sub Main()
      ' Instantiate delegate to reference UppercaseString method
      Dim convertMeth As ConvertMethod = AddressOf UppercaseString
      Dim name As String = "Dakota"
      ' Use delegate instance to call UppercaseString method
      Console.WriteLine(convertMeth(name))
   End Sub

   Private Function UppercaseString(inputString As String) As String
      Return inputString.ToUpper()
   End Function
End Module

Im folgende Beispiel wird dieser Code vereinfacht, durch die Instanziierung der Func<T,TResult> Delegaten aufrufen, anstatt explizit definieren einen neuen Delegaten und eine benannte Methode zugewiesen wird.The following example simplifies this code by instantiating the Func<T,TResult> delegate instead of explicitly defining a new delegate and assigning a named method to it.

using System;

public class GenericFunc
{
   public static void Main()
   {
      // Instantiate delegate to reference UppercaseString method
      Func<string, string> convertMethod = UppercaseString;
      string name = "Dakota";
      // Use delegate instance to call UppercaseString method
      Console.WriteLine(convertMethod(name));
   }

   private static string UppercaseString(string inputString)
   {
      return inputString.ToUpper();
   }
}
Module GenericFunc
   Public Sub Main()
      ' Instantiate delegate to reference UppercaseString method
      Dim convertMethod As Func(Of String, String) = AddressOf UppercaseString
      Dim name As String = "Dakota"
      ' Use delegate instance to call UppercaseString method
      Console.WriteLine(convertMethod(name))
   End Sub

   Private Function UppercaseString(inputString As String) As String
      Return inputString.ToUpper()
   End Function
End Module

Sie können auch die Func<T,TResult> delegieren mit anonymen Methoden in C# geschrieben, wie im folgende Beispiel veranschaulicht.You can also use the Func<T,TResult> delegate with anonymous methods in C#, as the following example illustrates. (Eine Einführung in anonyme Methoden, finden Sie unter anonyme Methoden.)(For an introduction to anonymous methods, see Anonymous Methods.)

using System;

public class Anonymous
{
   public static void Main()
   {
      Func<string, string> convert = delegate(string s)
         { return s.ToUpper();}; 
         
      string name = "Dakota";
      Console.WriteLine(convert(name));   
   }
}

Sie können auch einen Lambda-Ausdruck zuweisen einer Func<T,TResult> zu delegieren, wie im folgende Beispiel veranschaulicht.You can also assign a lambda expression to a Func<T,TResult> delegate, as the following example illustrates. (Eine Einführung in Lambda-Ausdrücke, finden Sie unter Lambda-Ausdrücke und Lambda-Ausdrücke.)(For an introduction to lambda expressions, see Lambda Expressions and Lambda Expressions.)

using System;

public class LambdaExpression
{
   public static void Main()
   {
      Func<string, string> convert = s => s.ToUpper();
         
      string name = "Dakota";
      Console.WriteLine(convert(name));   
   }
}
Module LambdaExpression
   Public Sub Main()
      Dim convert As Func(Of String, String) = Function(s) s.ToUpper()
      
      Dim name As String = "Dakota"
      Console.WriteLine(convert(name))  
   End Sub
End Module

Der zugrunde liegende Typ eines Lambda-Ausdrucks ist eine der generischen Func Delegaten.The underlying type of a lambda expression is one of the generic Func delegates. Dadurch wird es möglich, einen Lambda-Ausdruck als Parameter übergeben werden, ohne explizit einen Delegaten zuzuweisen.This makes it possible to pass a lambda expression as a parameter without explicitly assigning it to a delegate. Insbesondere, da viele Methoden der Typen in der System.Linq Namespace verfügen Func<T,TResult> Parameter können Sie übergeben diese Methoden einen Lambda-Ausdruck ohne explizit zu instanziieren ein Func<T,TResult> delegieren.In particular, because many methods of types in the System.Linq namespace have Func<T,TResult> parameters, you can pass these methods a lambda expression without explicitly instantiating a Func<T,TResult> delegate.

Gilt für:

Siehe auch