Converter<TInput,TOutput> Delegar

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Representa um método que converte um objeto de um tipo em outro tipo.

C#

public delegate TOutput Converter<in TInput,out TOutput>(TInput input);

C#

public delegate TOutput Converter<TInput,TOutput>(TInput input);

Parâmetros de tipo

TInput

O tipo de objeto a ser convertido.

Este parâmetro de tipo é contravariante. Isso significa que é possível usar o tipo especificado ou qualquer tipo menos derivado. Para obter mais informações sobre covariância e contravariância, consulte Covariância e contravariância em genéricos.

TOutput

O tipo para o qual o objeto de entrada será convertido.

Este parâmetro de tipo é covariante. Isso significa que é possível usar o tipo especificado ou qualquer tipo mais derivado. Para obter mais informações sobre covariância e contravariância, consulte Covariância e contravariância em genéricos.

Parâmetros

input

TInput

O objeto a ser convertido.

Valor Retornado

TOutput

O TOutput que representa o TInput convertido.

Exemplos

Esta seção contém dois exemplos de código. O primeiro demonstra o Converter<TInput,TOutput> delegado com o ConvertAll método da Array classe e o segundo demonstra o delegado com o ConvertAll método da List<T> classe genérica.

Exemplo 1

O exemplo de código a seguir define um método chamado PointFToPoint que converte uma PointF estrutura em uma Point estrutura. Em seguida, o exemplo cria uma matriz de PointF estruturas, cria um Converter<PointF, Point> delegado (Converter(Of PointF, Point)em Visual Basic) para representar o PointFToPoint método e passa o delegado para o ConvertAll método. O ConvertAll método passa cada elemento da lista de entrada para o PointFToPoint método e coloca os elementos convertidos em uma nova lista de Point estruturas. Ambas as listas são exibidas.

C#

using System;
using System.Drawing;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        // Create an array of PointF objects.
        PointF[] apf = {
            new PointF(27.8F, 32.62F),
            new PointF(99.3F, 147.273F),
            new PointF(7.5F, 1412.2F) };

        // Display each element in the PointF array.
        Console.WriteLine();
        foreach( PointF p in apf )
            Console.WriteLine(p);

        // Convert each PointF element to a Point object.
        Point[] ap = Array.ConvertAll(apf,
            new Converter<PointF, Point>(PointFToPoint));

        // Display each element in the Point array.
        Console.WriteLine();
        foreach( Point p in ap )
        {
            Console.WriteLine(p);
        }
    }

    public static Point PointFToPoint(PointF pf)
    {
        return new Point(((int) pf.X), ((int) pf.Y));
    }
}

/* This code example produces the following output:

{X=27.8, Y=32.62}
{X=99.3, Y=147.273}
{X=7.5, Y=1412.2}

{X=27,Y=32}
{X=99,Y=147}
{X=7,Y=1412}
 */

Exemplo 2

O exemplo de código a seguir define um método chamado PointFToPoint que converte uma PointF estrutura em uma Point estrutura. Em seguida, o exemplo cria uma List<T> estruturaPointF, cria um Converter\<PointF, Point> delegado (Converter(Of PointF, Point) em Visual Basic) para representar o PointFToPoint método e passa o delegado para o ConvertAll método. O ConvertAll método passa cada elemento da lista de entrada para o PointFToPoint método e coloca os elementos convertidos em uma nova lista de Point estruturas. Ambas as listas são exibidas.

C#

using System;
using System.Drawing;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        List<PointF> lpf = new List<PointF>();

        lpf.Add(new PointF(27.8F, 32.62F));
        lpf.Add(new PointF(99.3F, 147.273F));
        lpf.Add(new PointF(7.5F, 1412.2F));

        Console.WriteLine();
        foreach( PointF p in lpf )
        {
            Console.WriteLine(p);
        }

        List<Point> lp = lpf.ConvertAll(
            new Converter<PointF, Point>(PointFToPoint));

        Console.WriteLine();
        foreach( Point p in lp )
        {
            Console.WriteLine(p);
        }
    }

    public static Point PointFToPoint(PointF pf)
    {
        return new Point(((int) pf.X), ((int) pf.Y));
    }
}

/* This code example produces the following output:

{X=27.8, Y=32.62}
{X=99.3, Y=147.273}
{X=7.5, Y=1412.2}

{X=27,Y=32}
{X=99,Y=147}
{X=7,Y=1412}
 */

Comentários

Esse delegado é usado pelo ConvertAll método da Array classe e pelo ConvertAll método da List<T> classe para converter cada elemento da coleção de um tipo para outro.

Métodos de Extensão

GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.

Aplica-se a