List<T>.ConvertAll<TOutput>(Converter<T,TOutput>) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Collections.Generic

Zestaw:: System.Collections.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: List.cs

Źródło:: List.cs

Źródło:: List.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Konwertuje elementy bieżącego List<T> typu na inny typ i zwraca listę zawierającą przekonwertowane elementy.

public:
generic <typename TOutput>
 System::Collections::Generic::List<TOutput> ^ ConvertAll(Converter<T, TOutput> ^ converter);

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

member this.ConvertAll : Converter<'T, 'Output> -> System.Collections.Generic.List<'Output>

Public Function ConvertAll(Of TOutput) (converter As Converter(Of T, TOutput)) As List(Of TOutput)

Parametry typu

TOutput

Typ elementów tablicy docelowej.

Parametry

converter: Converter<T,TOutput>

Delegat Converter<TInput,TOutput> , który konwertuje każdy element z jednego typu na inny typ.

Zwraca

List<TOutput>

Typ List<T> docelowy zawierający przekonwertowane elementy z bieżącego List<T>elementu .

Wyjątki

ArgumentNullException

converter to null.

Przykłady

W poniższym przykładzie zdefiniowano metodę o nazwie PointFToPoint , która konwertuje PointF strukturę na Point strukturę. Następnie przykład tworzy struktury List<T>PointF , tworzy Converter\<PointF, Point> delegata (Converter(Of PointF, Point) w Visual Basic) do reprezentowania PointFToPoint metody i przekazuje delegata ConvertAll do metody. Metoda ConvertAll przekazuje każdy element listy wejściowej do PointFToPoint metody i umieszcza przekonwertowane elementy na nową listę Point struktur. Zostaną wyświetlone obie listy.

#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Collections::Generic;

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

void main()
{
    List<PointF>^ lpf = gcnew List<PointF>();

    lpf->Add(PointF(27.8F, 32.62F));
    lpf->Add(PointF(99.3F, 147.273F));
    lpf->Add(PointF(7.5F, 1412.2F));

    Console::WriteLine();
    for each(PointF p in lpf)
    {
        Console::WriteLine(p);
    }

    List<Point>^ lp = 
        lpf->ConvertAll<Point>(
            gcnew Converter<PointF, Point>(PointFToPoint)
        );

    Console::WriteLine();
    for each(Point p in lp)
    {
        Console::WriteLine(p);
    }
}

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

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

Imports System.Drawing
Imports System.Collections.Generic

Public Class Example

    Public Shared Sub Main()

        Dim lpf As New List(Of PointF)

        lpf.Add(New PointF(27.8, 32.62))
        lpf.Add(New PointF(99.3, 147.273))
        lpf.Add(New PointF(7.5, 1412.2))

        Console.WriteLine()
        For Each p As PointF In lpf
            Console.WriteLine(p)
        Next

        Dim lp As List(Of Point) = lpf.ConvertAll( _
            New Converter(Of PointF, Point)(AddressOf PointFToPoint))

        Console.WriteLine()
        For Each p As Point In lp
            Console.WriteLine(p)
        Next

    End Sub

    Public Shared Function PointFToPoint(ByVal pf As PointF) _
        As Point

        Return New Point(CInt(pf.X), CInt(pf.Y))
    End Function
End Class

' 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=28,Y=33}
'{X=99,Y=147}
'{X=8,Y=1412}

Uwagi

Element Converter<TInput,TOutput> jest delegatem do metody, która konwertuje obiekt na typ docelowy. Elementy bieżące List<T> są indywidualnie przekazywane do delegata Converter<TInput,TOutput> , a przekonwertowane elementy są zapisywane w nowym List<T>elemencie .

Obecny List<T> pozostaje niezmieniony.

Ta metoda jest operacją O(n), gdzie n to Count.

Dotyczy

Produkt	Wersje
.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

Zobacz też

Converter<TInput,TOutput>

Udostępnij za pośrednictwem