Func<T1,T2,TResult> Delegato
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Incapsula un metodo che presenta due parametri e restituisce un valore del tipo specificato dal parametro TResult
.
generic <typename T1, typename T2, typename TResult>
public delegate TResult Func(T1 arg1, T2 arg2);
public delegate TResult Func<in T1,in T2,out TResult>(T1 arg1, T2 arg2);
public delegate TResult Func<T1,T2,TResult>(T1 arg1, T2 arg2);
type Func<'T1, 'T2, 'Result> = delegate of 'T1 * 'T2 -> 'Result
Public Delegate Function Func(Of In T1, In T2, Out TResult)(arg1 As T1, arg2 As T2) As TResult
Public Delegate Function Func(Of T1, T2, TResult)(arg1 As T1, arg2 As T2) As TResult
Parametri di tipo
- T1
Tipo del primo 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.- T2
Tipo del secondo 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
- arg1
- T1
Primo parametro del metodo incapsulato da questo delegato.
- arg2
- T2
Secondo 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<T1,T2,TResult> delegato. In questo esempio viene dichiarata una Func<T1,T2,TResult> variabile e viene assegnata un'espressione lambda che accetta un String valore e un Int32 valore come parametri. L'espressione lambda restituisce true
se la lunghezza del String parametro è uguale al valore del Int32 parametro. Il delegato che incapsula questo metodo viene usato successivamente in una query per filtrare le stringhe in una matrice di stringhe.
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);
}
}
open System
open System.Linq
let predicate = Func<string, int, bool>(fun str index -> str.Length = index)
let words = [ "orange"; "apple"; "Article"; "elephant"; "star"; "and" ]
let aWords = words.Where predicate
for word in aWords do
printfn $"{word}"
Imports System.Collections.Generic
Imports System.Linq
Public Module Func3Example
Public Sub Main()
Dim predicate As Func(Of String, Integer, Boolean) = Function(str, index) str.Length = index
Dim words() As String = { "orange", "apple", "Article", "elephant", "star", "and" }
Dim aWords As IEnumerable(Of String) = words.Where(predicate)
For Each word As String In aWords
Console.WriteLine(word)
Next
End Sub
End Module
Commenti
È possibile usare questo delegato per rappresentare un metodo che può essere passato come parametro senza dichiarare esplicitamente un delegato personalizzato. Il metodo incapsulato deve corrispondere alla firma del metodo definita da questo delegato. Ciò significa che il metodo incapsulato deve avere due parametri, ognuno dei quali viene passato per valore e che deve restituire un valore.
Nota
Per fare riferimento a un metodo con due parametri e restituisce void
( in F#) (o in Visual Basic, dichiarato come un Sub
oggetto anziché come Function
), usare invece il delegato genericoAction<T1,T2>unit
.
Quando si usa il Func<T1,T2,TResult> delegato non è necessario definire in modo esplicito un delegato che incapsula un metodo con due parametri. Ad esempio, il codice seguente dichiara in modo esplicito un delegato denominato ExtractMethod
e assegna un riferimento al metodo all'istanza ExtractWords
del delegato.
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);
}
}
type ExtractMethod = delegate of string * int -> string []
let extractWords (phrase: string) limit =
let delimiters = [| ' ' |]
if limit > 0 then
phrase.Split(delimiters, limit)
else
phrase.Split delimiters
// Instantiate delegate to reference extractWords function
let extractMeth = ExtractMethod extractWords
let title = "The Scarlet Letter"
// Use delegate instance to call extractWords function and display result
for word in extractMeth.Invoke(title, 5) do
printfn $"{word}"
' Declare a delegate to represent string extraction method
Delegate Function ExtractMethod(ByVal stringToManipulate As String, _
ByVal maximum As Integer) As String()
Module DelegateExample
Public Sub Main()
' Instantiate delegate to reference ExtractWords method
Dim extractMeth As ExtractMethod = AddressOf ExtractWords
Dim title As String = "The Scarlet Letter"
' Use delegate instance to call ExtractWords method and display result
For Each word As String In extractMeth(title, 5)
Console.WriteLine(word)
Next
End Sub
Private Function ExtractWords(phrase As String, limit As Integer) As String()
Dim delimiters() As Char = {" "c}
If limit > 0 Then
Return phrase.Split(delimiters, limit)
Else
Return phrase.Split(delimiters)
End If
End Function
End Module
L'esempio seguente semplifica questo codice creando un'istanza di un Func<T1,T2,TResult> delegato anziché definire in modo esplicito un nuovo delegato e assegnando un metodo denominato.
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);
}
}
open System
let extractWords (phrase: string) limit =
let delimiters = [| ' ' |]
if limit > 0 then
phrase.Split(delimiters, limit)
else
phrase.Split delimiters
// Instantiate delegate to reference extractWords function
let extractMethod = Func<string, int, string[]> extractWords
let title = "The Scarlet Letter"
// Use delegate instance to call extractWords function and display result
for word in extractMethod.Invoke(title, 5) do
printfn $"{word}"
Module GenericFunc
Public Sub Main()
' Instantiate delegate to reference ExtractWords method
Dim extractMeth As Func(Of String, Integer, String()) = AddressOf ExtractWords
Dim title As String = "The Scarlet Letter"
' Use delegate instance to call ExtractWords method and display result
For Each word As String In extractMeth(title, 5)
Console.WriteLine(word)
Next
End Sub
Private Function ExtractWords(phrase As String, limit As Integer) As String()
Dim delimiters() As Char = {" "c}
If limit > 0 Then
Return phrase.Split(delimiters, limit)
Else
Return phrase.Split(delimiters)
End If
End Function
End Module
È possibile usare il delegato con metodi anonimi in C#, come illustrato nell'esempio Func<T1,T2,TResult> seguente. Per un'introduzione ai metodi anonimi, vedere Metodi anonimi.
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);
}
}
È anche possibile assegnare un'espressione lambda a un Func<T1,T2,TResult> delegato, come illustrato nell'esempio seguente. Per un'introduzione alle espressioni lambda, vedere Espressioni lambda (VB), Espressioni Lambda (C#) e Espressioni Lambda (F#).)
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);
}
}
open System
let separators = [| ' ' |]
let extract =
Func<string, int, string []> (fun s i ->
if i > 0 then
s.Split(separators, i)
else
s.Split separators)
let title = "The Scarlet Letter"
// Use Func instance to call lambda expression and display result
for word in extract.Invoke(title, 5) do
printfn $"{word}"
Module LambdaExpression
Public Sub Main()
Dim separators() As Char = {" "c}
Dim extract As Func(Of String, Integer, String()) = Function(s, i) _
CType(iif(i > 0, s.Split(separators, i), s.Split(separators)), String())
Dim title As String = "The Scarlet Letter"
For Each word As String In extract(title, 5)
Console.WriteLine(word)
Next
End Sub
End Module
Il tipo sottostante di un'espressione lambda è uno dei delegati generici Func
. In questo modo è possibile passare un'espressione lambda come parametro senza assegnarlo in modo esplicito a un delegato. In particolare, poiché molti metodi di tipi nello spazio dei nomi hanno Func<T1,T2,TResult> parametri, è possibile passare questi metodi a un'espressione System.Linq lambda senza creare un'istanza esplicita di un Func<T1,T2,TResult> delegato.
Metodi di estensione
GetMethodInfo(Delegate) |
Ottiene un oggetto che rappresenta il metodo rappresentato dal delegato specificato. |