Func<T,TResult> Delegasikan
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Merangkum metode yang memiliki satu parameter dan mengembalikan nilai jenis yang ditentukan oleh TResult parameter .
generic <typename T, typename TResult>
public delegate TResult Func(T arg);public delegate TResult Func<in T,out TResult>(T arg);public delegate TResult Func<T,TResult>(T arg);type Func<'T, 'Result> = delegate of 'T -> 'ResultPublic Delegate Function Func(Of In T, Out TResult)(arg As T) As TResult Public Delegate Function Func(Of T, TResult)(arg As T) As TResult - T
Jenis parameter metode yang dienkapsulasi delegasi ini.
Parameter jenis ini bersifat kontravarian. Artinya, Anda bisa menggunakan jenis yang Anda tentukan atau jenis apa pun yang tidak banyak diturunkan. Untuk informasi lebih lanjut tentang kovariansi dan kontravariansi, lihat Kovariansi dan Kontravariansi dalam Generik.- TResult
Jenis nilai pengembalian metode yang dienkapsulasi delegasi ini.
Parameter jenis ini bersifat kovarian. Artinya, Anda bisa menggunakan jenis yang Anda tentukan atau jenis apa pun yang lebih banyak diturunkan. Untuk informasi lebih lanjut tentang kovariansi dan kontravariansi, lihat Kovariansi dan Kontravariansi dalam Generik.- arg
- T
Parameter metode yang dienkapsulasi delegasi ini.
Nilai pengembalian metode yang dienkapsulasi delegasi ini.
Contoh berikut menunjukkan cara mendeklarasikan dan menggunakan Func<T,TResult> delegasi. Contoh ini mendeklarasikan Func<T,TResult> variabel dan menetapkan ekspresi lambda yang mengonversi karakter dalam string menjadi huruf besar. Delegasi yang merangkum metode ini kemudian diteruskan ke Enumerable.Select metode untuk mengubah string dalam array string menjadi huruf besar.
// 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
*/
open System
open System.Linq
// Declare a Func variable and assign a lambda expression to the
// variable. The function takes a string and converts it to uppercase.
let selector = Func<string, string>(fun str -> str.ToUpper())
// Create a list of strings.
let words = [ "orange"; "apple"; "Article"; "elephant" ]
// Query the list and select strings according to the selector function.
let aWords = words.Select selector
// Output the results to the console.
for word in aWords do
printfn $"{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
// Declare a delegate
delegate String ^ MyDel(String ^);
// Create wrapper class and function that takes in a string and converts it to uppercase
ref class DelegateWrapper {
public:
String ^ ToUpper(String ^ s) {
return s->ToUpper();
}
};
int main() {
// Declare delegate
DelegateWrapper ^ delegateWrapper = gcnew DelegateWrapper;
MyDel ^ DelInst = gcnew MyDel(delegateWrapper, &DelegateWrapper::ToUpper);
// Cast into Func
Func<String ^, String ^> ^ selector = reinterpret_cast<Func<String ^, String ^> ^>(DelInst);
// Create an array of strings
array<String ^> ^ words = { "orange", "apple", "Article", "elephant" };
// Query the array and select strings according to the selector method
Generic::IEnumerable<String ^> ^ aWords = Enumerable::Select((Generic::IEnumerable<String^>^)words, selector);
// Output the results to the console
for each(String ^ word in aWords)
Console::WriteLine(word);
/*
This code example produces the following output:
ORANGE
APPLE
ARTICLE
ELEPHANT
*/
}
Anda dapat menggunakan delegasi ini untuk mewakili metode yang dapat diteruskan sebagai parameter tanpa secara eksplisit menyatakan delegasi kustom. Metode yang dienkapsulasi harus sesuai dengan tanda tangan metode yang ditentukan oleh delegasi ini. Ini berarti bahwa metode yang dienkapsulasi harus memiliki satu parameter yang diteruskan ke dalamnya berdasarkan nilai, dan harus mengembalikan nilai.
Catatan
Untuk mereferensikan metode yang memiliki satu parameter dan mengembalikan void (atau di Visual Basic, yang dinyatakan sebagai Sub bukan sebagai Function), gunakan delegasi generik Action<T> sebagai gantinya.
Saat Anda menggunakan Func<T,TResult> delegasi, Anda tidak perlu secara eksplisit menentukan delegasi yang merangkum metode dengan satu parameter. Misalnya, kode berikut secara eksplisit mendeklarasikan delegasi bernama ConvertMethod dan menetapkan referensi ke UppercaseString metode ke instans delegasinya.
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();
}
}
type ConvertMethod = delegate of string -> string
let uppercaseString (inputString: string) =
inputString.ToUpper()
// Instantiate delegate to reference uppercaseString function
let convertMeth = ConvertMethod uppercaseString
let name = "Dakota"
// Use delegate instance to call uppercaseString function
printfn $"{convertMeth.Invoke name}"
' 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
Contoh berikut menyederhanakan kode ini dengan membuat instans delegasi Func<T,TResult> alih-alih secara eksplisit mendefinisikan delegasi baru dan menetapkan metode bernama ke dalamnya.
// 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
open System
let uppercaseString (inputString: string) =
inputString.ToUpper()
// Instantiate delegate to reference uppercaseString function
let convertMethod = Func<string, string> uppercaseString
let name = "Dakota"
// Use delegate instance to call uppercaseString function
printfn $"{convertMethod.Invoke name}"
// This code example produces the following output:
// DAKOTA
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
Anda juga dapat menggunakan Func<T,TResult> delegasi dengan metode anonim di C#, seperti yang diilustrasikan contoh berikut. (Untuk pengenalan metode anonim, lihat Metode Anonim.)
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
Anda juga dapat menetapkan ekspresi lambda ke Func<T,TResult> delegasi, seperti yang diilustrasikan contoh berikut. (Untuk pengenalan ekspresi lambda, lihat Ekspresi Lambda (VB), Ekspresi Lambda (C#) dan Ekspresi Lambda (F#).)
Func<string, string> convert = s => s.ToUpper();
string name = "Dakota";
Console.WriteLine(convert(name));
// This code example produces the following output:
//
// DAKOTA
open System
let convert = Func<string, string>(fun s -> s.ToUpper())
let name = "Dakota"
printfn $"{convert.Invoke name}"
// This code example produces the following output:
// DAKOTA
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
Jenis ekspresi lambda yang mendasar adalah salah satu delegasi generik Func . Ini memungkinkan untuk meneruskan ekspresi lambda sebagai parameter tanpa secara eksplisit menetapkannya ke delegasi. Secara khusus, karena banyak metode jenis di System.Linq namespace memiliki Func<T,TResult> parameter, Anda dapat meneruskan metode ini ekspresi lambda tanpa secara eksplisit membuat Func<T,TResult> instans delegasi.
|
Get |
Mendapatkan objek yang mewakili metode yang diwakili oleh delegasi yang ditentukan. |
| Produk | Versi |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Umpan balik .NET
.NET adalah proyek sumber terbuka. Pilih tautan untuk memberikan umpan balik: