List<T>.ConvertAll<TOutput>(Converter<T,TOutput>) Método

Definición

Convierte en otro tipo los elementos incluidos en la List<T> actual y devuelve una lista que contiene los elementos convertidos.

C#
public System.Collections.Generic.List<TOutput> ConvertAll<TOutput> (Converter<T,TOutput> converter);

Parámetros de tipo

TOutput

Tipo de los elementos de la matriz de destino.

Parámetros

converter
Converter<T,TOutput>

Delegado Converter<TInput,TOutput> que convierte cada elemento de un tipo en otro tipo.

Devoluciones

List<TOutput>

List<T> del tipo de destino que contiene los elementos convertidos de la List<T> actual.

Excepciones

converter es null.

Ejemplos

En el ejemplo siguiente se define un método denominado PointFToPoint que convierte una PointF estructura en una Point estructura. A continuación, en el ejemplo se crea un List<T> objeto de PointF estructuras, se crea un Converter\<PointF, Point> delegado (Converter(Of PointF, Point) en Visual Basic) para representar el PointFToPoint método y se pasa el delegado al ConvertAll método . El ConvertAll método pasa cada elemento de la lista de entrada al PointFToPoint método y coloca los elementos convertidos en una nueva lista de Point estructuras. Se muestran ambas listas.

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}
 */

Comentarios

Converter<TInput,TOutput> es un delegado en un método que convierte un objeto en el tipo de destino. Los elementos del actual List<T> se pasan individualmente al Converter<TInput,TOutput> delegado y los elementos convertidos se guardan en el nuevo List<T>.

El actual List<T> permanece sin cambios.

Este método es una operación de O(n), donde n es Count.

Se aplica a

Producto Versiones
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 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 2.0, 2.1

Consulte también