Func<T1,T2,T3,TResult> Delegado
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Encapsula un método que tiene tres parámetros y devuelve un valor del tipo que especifica el parámetro TResult.
generic <typename T1, typename T2, typename T3, typename TResult>
public delegate TResult Func(T1 arg1, T2 arg2, T3 arg3);public delegate TResult Func<in T1,in T2,in T3,out TResult>(T1 arg1, T2 arg2, T3 arg3);public delegate TResult Func<T1,T2,T3,TResult>(T1 arg1, T2 arg2, T3 arg3);type Func<'T1, 'T2, 'T3, 'Result> = delegate of 'T1 * 'T2 * 'T3 -> 'ResultPublic Delegate Function Func(Of In T1, In T2, In T3, Out TResult)(arg1 As T1, arg2 As T2, arg3 As T3) As TResult Public Delegate Function Func(Of T1, T2, T3, TResult)(arg1 As T1, arg2 As T2, arg3 As T3) As TResult Parámetros de tipo
- T1
Tipo del primer parámetro del método que este delegado encapsula.
Este parámetro de tipo es contravariante, es decir, puede usar el tipo que haya especificado o cualquier tipo menos derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.- T2
Tipo del segundo parámetro del método que este delegado encapsula.
Este parámetro de tipo es contravariante, es decir, puede usar el tipo que haya especificado o cualquier tipo menos derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.- T3
Tipo del tercer parámetro del método que este delegado encapsula.
Este parámetro de tipo es contravariante, es decir, puede usar el tipo que haya especificado o cualquier tipo menos derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.- TResult
Tipo del valor devuelto del método que este delegado encapsula.
Este parámetro de tipo es covariante, es decir, puede usar el tipo que haya especificado o cualquier tipo más derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.Parámetros
- arg1
- T1
Primer parámetro del método que este delegado encapsula.
- arg2
- T2
Segundo parámetro del método que este delegado encapsula.
- arg3
- T3
Tercer parámetro del método que este delegado encapsula.
Valor devuelto
Valor devuelto del método que este delegado encapsula.
Ejemplos
En el ejemplo siguiente se muestra cómo declarar y usar un Func<T1,T2,TResult> delegado. En este ejemplo se declara una Func<T1,T2,TResult> variable y se le asigna una expresión lambda que toma un String valor y un Int32 valor como parámetros. La expresión lambda devuelve true si la longitud del String parámetro es igual al valor del Int32 parámetro . El delegado que encapsula este método se usa posteriormente en una consulta para filtrar cadenas en una matriz de cadenas.
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
Comentarios
Puede usar este delegado para representar un método que se puede pasar como parámetro sin declarar explícitamente un delegado personalizado. El método encapsulado debe corresponder a la firma del método definida por este delegado. Esto significa que el método encapsulado debe tener tres parámetros, cada uno de los cuales se le pasa por valor y que debe devolver un valor.
Nota
Para hacer referencia a un método que tiene tres parámetros y devuelve void (unit en F#) (o en Visual Basic, que se declara como en Sub lugar de como Function), use el delegado genérico Action<T1,T2,T3> en su lugar.
Cuando se usa el Func<T1,T2,T3,TResult> delegado, no es necesario definir explícitamente un delegado que encapsula un método con tres parámetros. Por ejemplo, el código siguiente declara explícitamente un delegado genérico denominado ParseNumber y asigna una referencia al Parse método a su instancia de delegado.
using System;
using System.Globalization;
delegate T ParseNumber<T>(string input, NumberStyles styles,
IFormatProvider provider);
public class DelegateExample
{
public static void Main()
{
string numericString = "-1,234";
ParseNumber<int> parser = int.Parse;
Console.WriteLine(parser(numericString,
NumberStyles.Integer | NumberStyles.AllowThousands,
CultureInfo.InvariantCulture));
}
}
open System
open System.Globalization
type ParseNumber<'T> = delegate of (string * NumberStyles * IFormatProvider) -> 'T
let numericString = "-1,234"
let parser = ParseNumber<int> Int32.Parse
parser.Invoke(
numericString,
NumberStyles.Integer ||| NumberStyles.AllowThousands,
CultureInfo.InvariantCulture )
|> printfn "%i"
Imports System.Globalization
Delegate Function ParseNumber(Of T)(input As String, styles As NumberStyles, _
provider As IFormatProvider) As T
Module DelegateExample
Public Sub Main()
Dim numericString As String = "-1,234"
Dim parser As ParseNumber(Of Integer) = AddressOf Integer.Parse
Console.WriteLine(parser(numericString, _
NumberStyles.Integer Or NumberStyles.AllowThousands, _
CultureInfo.InvariantCulture))
End Sub
End Module
En el ejemplo siguiente se simplifica este código mediante la creación de instancias del Func<T1,T2,T3,TResult> delegado en lugar de definir explícitamente un nuevo delegado y asignarle un método con nombre.
using System;
using System.Globalization;
public class GenericFunc
{
public static void Main()
{
string numericString = "-1,234";
Func<string, NumberStyles, IFormatProvider, int> parser = int.Parse;
Console.WriteLine(parser(numericString,
NumberStyles.Integer | NumberStyles.AllowThousands,
CultureInfo.InvariantCulture));
}
}
open System
open System.Globalization
let parseInt (str: string) styles format = Int32.Parse(str, styles, format)
let numericString = "-1,234"
let parser =
Func<string, NumberStyles, IFormatProvider, int> parseInt
parser.Invoke(
numericString,
NumberStyles.Integer ||| NumberStyles.AllowThousands,
CultureInfo.InvariantCulture )
|> printfn "%i"
Imports System.Globalization
Module GenericFunc
Public Sub Main()
Dim numericString As String = "-1,234"
Dim parser As Func(Of String, NumberStyles, IFormatProvider, Integer) _
= AddressOf Integer.Parse
Console.WriteLine(parser(numericString, _
NumberStyles.Integer Or NumberStyles.AllowThousands, _
CultureInfo.InvariantCulture))
End Sub
End Module
Puede usar el Func<T1,T2,T3,TResult> delegado con métodos anónimos en C#, como se muestra en el ejemplo siguiente. (Para obtener una introducción a los métodos anónimos, consulte Métodos anónimos).
using System;
using System.Globalization;
public class Anonymous
{
public static void Main()
{
string numericString = "-1,234";
Func<string, NumberStyles, IFormatProvider, int> parser =
delegate(string s, NumberStyles sty, IFormatProvider p)
{ return int.Parse(s, sty, p); };
Console.WriteLine(parser(numericString,
NumberStyles.Integer | NumberStyles.AllowThousands,
CultureInfo.InvariantCulture));
}
}
También puede asignar una expresión lambda a un Func<T1,T2,T3,TResult> delegado, como se muestra en el ejemplo siguiente. (Para obtener una introducción a las expresiones lambda, vea Expresiones lambda (VB),Expresiones lambda (C#) y Expresiones lambda (F#)).
using System;
using System.Globalization;
public class LambdaExpression
{
public static void Main()
{
string numericString = "-1,234";
Func<string, NumberStyles, IFormatProvider, int> parser = (s, sty, p)
=> int.Parse(s, sty, p);
Console.WriteLine(parser(numericString,
NumberStyles.Integer | NumberStyles.AllowThousands,
CultureInfo.InvariantCulture));
}
}
open System
open System.Globalization
let numericString = "-1,234"
let parser = Func<string, NumberStyles, IFormatProvider, int>(fun s sty p ->
Int32.Parse(s, sty, p))
parser.Invoke(numericString,
NumberStyles.Integer ||| NumberStyles.AllowThousands,
CultureInfo.InvariantCulture)
|> printfn "%i"
Imports System.Globalization
Module LambdaExpression
Public Sub Main()
Dim numericString As String = "-1,234"
Dim parser As Func(Of String, NumberStyles, IFormatProvider, Integer) _
= Function(s, sty, p) Integer.Parse(s, sty, p)
Console.WriteLine(parser(numericString, _
NumberStyles.Integer Or NumberStyles.AllowThousands, _
CultureInfo.InvariantCulture))
End Sub
End Module
El tipo subyacente de una expresión lambda es uno de los delegados genéricos Func . Esto permite pasar una expresión lambda como parámetro sin asignarla explícitamente a un delegado. En concreto, dado que muchos métodos de tipos del System.Linq espacio de nombres tienen Func parámetros, puede pasar estos métodos a una expresión lambda sin crear instancias explícitas de un Func delegado.
Métodos de extensión
| GetMethodInfo(Delegate) |
Obtiene un objeto que representa el método representado por el delegado especificado. |
Se aplica a
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de