Func<T1,T2,TResult> Delegát
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Zapouzdří metodu, která má dva parametry, a vrátí hodnotu typu určeného parametrem 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 -> 'ResultPublic 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 - T1
Typ prvního parametru metody, který tento delegát zapouzdřuje.
Tento parametr typu je kontravariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je méně odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.- T2
Typ druhého parametru metody, který tento delegát zapouzdřuje.
Tento parametr typu je kontravariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je méně odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.- TResult
Typ návratové hodnoty metody, kterou tento delegát zapouzdřuje.
Tento parametr typu je kovariantní. To znamená, že můžete použít buď zadaný typ, nebo libovolný typ, který je více odvozený. Další informace o kovarianci a kontravarianci najdete v tématu popisujícím kovarianci a kontravarianci u parametrického polymorfismu.- arg1
- T1
První parametr metody, kterou tento delegát zapouzdřuje.
- arg2
- T2
Druhý parametr metody, kterou tento delegát zapouzdřuje.
- TResult
Návratová hodnota metody, kterou tento delegát zapouzdřuje.
Následující příklad ukazuje, jak deklarovat a používat delegáta Func<T1,T2,TResult> . Tento příklad deklaruje proměnnou Func<T1,T2,TResult> a přiřadí ji výraz lambda, který přebírá String hodnotu a Int32 hodnotu jako parametry. Výraz lambda vrátí true , pokud je délka String parametru rovna hodnotě parametru Int32 . Delegát, který zapouzdřuje tuto metodu, se následně používá v dotazu k filtrování řetězců v poli řetězců.
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
Tento delegát můžete použít k reprezentaci metody, která se dá předat jako parametr, aniž byste explicitně deklarovali vlastního delegáta. Zapouzdřená metoda musí odpovídat podpisu metody definované tímto delegátem. To znamená, že zapouzdřená metoda musí mít dva parametry, z nichž každá je předána hodnotou a že musí vrátit hodnotu.
Poznámka
Chcete-li odkazovat na metodu, která má dva parametry a vrací void (unitv jazyce F#) (nebo v Visual Basic, která je deklarována jako Sub místo jako ), Functionpoužijte místo toho obecný Action<T1,T2> delegát.
Když použijete Func<T1,T2,TResult> delegáta, nemusíte explicitně definovat delegáta, který zapouzdřuje metodu se dvěma parametry. Například následující kód explicitně deklaruje delegáta pojmenovaný ExtractMethod a přiřadí odkaz na metodu ExtractWords k jeho instanci delegáta.
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
Následující příklad tento kód zjednodušuje vytvořením instance delegáta Func<T1,T2,TResult> místo explicitního definování nového delegáta a přiřazením pojmenované metody k němu.
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
Delegáta můžete použít Func<T1,T2,TResult> s anonymními metodami v jazyce C#, jak je znázorněno v následujícím příkladu. (Úvod k anonymním metodám naleznete v tématu Anonymní metody.)
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);
}
}
Výraz lambda můžete také přiřadit delegátu Func<T1,T2,TResult> , jak je znázorněno v následujícím příkladu. (Úvod k výrazům lambda najdete v tématu Výrazy lambda (VB), výrazy lambda (C#) a výrazy 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
Základní typ výrazu lambda je jedním z obecných Func delegátů. To umožňuje předat výraz lambda jako parametr, aniž byste ho explicitně přiřadili delegátu. Zejména proto, že mnoho metod typů v System.Linq oboru názvů má Func<T1,T2,TResult> parametry, můžete tyto metody předat výraz lambda, aniž byste explicitně vytvořili instanci delegáta Func<T1,T2,TResult> .
|
Get |
Získá objekt, který představuje metodu reprezentovanou zadaným delegátem. |