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 folgenden Beispiel wird veranschaulicht, wie ein Func<T,TResult> Delegat deklariert und verwendet wird.The following example demonstrates how to declare and use a Func<T,TResult> delegate. In diesem Beispiel wird Func<T,TResult> eine Variable deklariert und ihr ein Lambda-Ausdruck zugewiesen, 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 Enumerable.Select an die-Methode weitergegeben, um die Zeichen folgen in einem Array von Zeichen folgen 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

Mit diesem Delegaten können Sie eine Methode darstellen, die als Parameter übergeben werden kann, 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 gekapselte Methode muss der Methoden Signatur entsprechen, die von diesem Delegaten definiert wird.The encapsulated method must correspond to the method signature that is defined by this delegate. Dies bedeutet, dass die gekapselte Methode über einen Parameter verfügen muss, der als Wert übergeben wird, und dass ein Wert zurückgegeben werden 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

Verwenden Sie stattdessen den generischen void Sub Action<T> Delegaten, um auf eine Methode zu verweisen, die über einen Parameter verfügt und zurückgibt Function(oder in Visual Basic, die als deklariert wird, und nicht als).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.

Wenn Sie den Func<T,TResult> -Delegaten verwenden, müssen Sie nicht explizit einen Delegaten definieren, der eine Methode mit einem einzelnen 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 z. b. explizit einen Delegaten mit dem Namen ConvertMethod und weist der Delegatinstanz einen Verweis auf die UppercaseString -Methode zu.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 folgenden Beispiel wird dieser Code vereinfacht, indem der Func<T,TResult> Delegat instanziiert wird, anstatt explizit einen neuen Delegaten zu definieren und ihm eine benannte Methode zuzuweisen.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 den Func<T,TResult> Delegaten auch mit anonymen Methoden in C#verwenden, wie im folgenden Beispiel veranschaulicht.You can also use the Func<T,TResult> delegate with anonymous methods in C#, as the following example illustrates. (Eine Einführung zu anonymen 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 einem Delegaten auch einen Lambda- Func<T,TResult> Ausdruck zuweisen, wie im folgenden 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 einer der generischen Func Delegaten.The underlying type of a lambda expression is one of the generic Func delegates. Dadurch ist es möglich, einen Lambda-Ausdruck als Parameter zu übergeben, ohne ihn explizit einem Delegaten zuzuweisen.This makes it possible to pass a lambda expression as a parameter without explicitly assigning it to a delegate. Insbesondere weil viele Methoden von Typen im System.Linq -Namespace Parameter aufweisen Func<T,TResult> , können Sie diese Methoden als Lambda-Ausdruck übergeben, ohne einen Func<T,TResult> Delegaten explizit zu instanziieren.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.

Erweiterungsmethoden

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

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.Gets an object that represents the method represented by the specified delegate.

Gilt für:

Siehe auch