Func<T,TResult> Delegato

Definizione

Spazio dei nomi:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

System.Core.dll

Assembly:

mscorlib.dll

Incapsula un metodo che ha un parametro e restituisce un valore del tipo specificato dal parametro TResult.

C#

public delegate TResult Func<in T,out TResult>(T arg);

C#

public delegate TResult Func<T,TResult>(T arg);

Parametri di tipo

T

Tipo del parametro del metodo incapsulato da questo delegato.

Questo parametro di tipo è controvariante, ovvero puoi usare il tipo specificato o qualsiasi tipo meno derivato. Per altre informazioni sulla covarianza e la controvarianza, vedi Covarianza e controvarianza nei generics.

TResult

Tipo del valore restituito del metodo incapsulato da questo delegato.

Questo parametro di tipo è covariante, ovvero puoi usare il tipo specificato o qualsiasi tipo più derivato. Per altre informazioni sulla covarianza e la controvarianza, vedi Covarianza e controvarianza nei generics.

Parametri

arg

T

Parametro del metodo incapsulato da questo delegato.

Valore restituito

TResult

Valore restituito del metodo incapsulato da questo delegato.

Esempio

Nell'esempio seguente viene illustrato come dichiarare e usare un Func<T,TResult> delegato. Questo esempio dichiara una Func<T,TResult> variabile e le assegna un'espressione lambda che converte in maiuscolo i caratteri di una stringa. Il delegato che incapsula questo metodo viene successivamente passato al metodo per modificare le stringhe in una Enumerable.Select matrice di stringhe in lettere maiuscole.

C#

// 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

*/

Commenti

È possibile usare questo delegato per rappresentare un metodo che può essere passato come parametro senza dichiarare in modo esplicito un delegato personalizzato. Il metodo incapsulato deve corrispondere alla firma del metodo definita da questo delegato. Ciò significa che il metodo incapsulato deve avere un parametro che viene passato per valore e che deve restituire un valore.

Nota

Per fare riferimento a un metodo che dispone di un parametro e restituisce (o in Visual Basic, dichiarato come anziché come ), usare invece void Sub il delegato generico Function Action<T> .

Quando si usa il delegato , non è necessario definire in modo esplicito un Func<T,TResult> delegato che incapsula un metodo con un singolo parametro. Ad esempio, il codice seguente dichiara in modo esplicito un delegato denominato e assegna un ConvertMethod riferimento al UppercaseString metodo all'istanza del delegato.

C#

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

L'esempio seguente semplifica questo codice creando un'istanza del delegato invece di definire in modo esplicito un nuovo delegato e assegnando a esso Func<T,TResult> un metodo denominato.

C#

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

string UppercaseString(string inputString)
{
   return inputString.ToUpper();
}

// This code example produces the following output:
//
//    DAKOTA

È anche possibile usare il Func<T,TResult> delegato con metodi anonimi in C#, come illustrato nell'esempio seguente. Per un'introduzione ai metodi anonimi, vedere Metodi anonimi.

C#

 Func<string, string> convert = delegate(string s)
    { return s.ToUpper();};

 string name = "Dakota";
 Console.WriteLine(convert(name));

// This code example produces the following output:
//
//    DAKOTA

È anche possibile assegnare un'espressione lambda a Func<T,TResult> un delegato, come illustrato nell'esempio seguente. Per un'introduzione alle espressioni lambda, vedere Espressioni lambda (VB),Espressioni lambda (C#) ed Espressioni lambda (F#).

C#

Func<string, string> convert = s => s.ToUpper();

string name = "Dakota";
Console.WriteLine(convert(name));

// This code example produces the following output:
//
//    DAKOTA

Il tipo sottostante di un'espressione lambda è uno dei delegati Func generici. In questo modo è possibile passare un'espressione lambda come parametro senza assegnarla in modo esplicito a un delegato. In particolare, poiché molti metodi di tipi nello spazio dei nomi dispongono di parametri, è possibile passare questi metodi a un'espressione lambda senza creare esplicitamente System.Linq Func<T,TResult> un'istanza di un Func<T,TResult> delegato.

Metodi di estensione

GetMethodInfo(Delegate)

Ottiene un oggetto che rappresenta il metodo rappresentato dal delegato specificato.

Si applica a

Vedi anche

• Espressioni lambda (Guida per programmatori C#)
• Espressioni lambda: parola chiave fun (F#)
• Espressioni lambda (Visual Basic)
• Delegati (Guida per programmatori C#)
• Delegati (F#)
• Delegati (Visual Basic)