語言

List<T>.ConvertAll<TOutput>(Converter<T,TOutput>) 方法

定義

命名空間:
System.Collections.Generic
組件:
netstandard.dll, System.Collections.dll
組件:
System.Collections.dll
組件:
mscorlib.dll
組件:
netstandard.dll
來源:
List.cs
來源:
List.cs
來源:
List.cs
來源:
List.cs
來源:
List.cs

將目前 List<T> 的元素轉換成其他類型，並回傳包含已轉換元素的清單。

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)

類型參數

TOutput

目標陣列元素的類型。

參數

converter
Converter<T,TOutput>

一個 Converter<TInput,TOutput> 代理，將每個元素從一種類型轉換成另一種類型。

傳回

List<TOutput>

List<T> A，包含從當前 List<T>轉換的元素的目標型別。

例外狀況

ArgumentNullException

converter 是 null。

範例

以下範例定義了一個名為 PointFToPoint S 的方法，該方法將結構 PointF 轉換成結構 Point 。 範例接著建立一個List<T>結構的 PointF，建立一個 Converter\<PointF, Point>代理（在 Visual Basic 中稱為 Converter(Of PointF, Point)）來表示 PointFToPoint 方法，並將代理傳送給 ConvertAll 方法。 該 ConvertAll 方法將輸入清單中的每個元素傳給方法， PointFToPoint 並將轉換後的元素放入新的結構清單 Point 中。 兩個清單都會顯示。

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}

備註

這是 Converter<TInput,TOutput> 將物件轉換為目標型別的方法代理。 電流 List<T> 中的元素會分別傳給代理， Converter<TInput,TOutput> 轉換後的元素則儲存在新的 List<T>中。

水流 List<T> 保持不變。

此方法為 O（n） 運算，其中 n 為 Count。

適用於

另請參閱