Array.ConvertAll<TInput,TOutput> Метод

Определение

Пространство имен:
System
Сборки:
netstandard.dll, System.Runtime.dll
Сборка:
System.Runtime.dll
Сборка:
mscorlib.dll
Сборка:
netstandard.dll
Исходный код:
Array.cs
Исходный код:
Array.cs
Исходный код:
Array.cs
Исходный код:
Array.cs
Исходный код:
Array.cs

Преобразует массив одного типа в массив другого типа.

public:
generic <typename TInput, typename TOutput>
 static cli::array <TOutput> ^ ConvertAll(cli::array <TInput> ^ array, Converter<TInput, TOutput> ^ converter);
public static TOutput[] ConvertAll<TInput,TOutput>(TInput[] array, Converter<TInput,TOutput> converter);
static member ConvertAll : 'Input[] * Converter<'Input, 'Output> -> 'Output[]
Public Shared Function ConvertAll(Of TInput, TOutput) (array As TInput(), converter As Converter(Of TInput, TOutput)) As TOutput()

Параметры типа

TInput

Тип элементов исходного массива.

TOutput

Тип элементов целевого массива.

Параметры

array
TInput[]

Одномерный, отсчитываемый Array от нуля для преобразования в целевой тип.

converter
Converter<TInput,TOutput>

Объект, Converter<TInput,TOutput> который преобразует каждый элемент из одного типа в другой тип.

Возвращаемое значение

TOutput[]

Массив целевого типа, содержащего преобразованные элементы из исходного массива.

Исключения

ArgumentNullException

array равно null.

–или–

converter равно null.

Примеры

В следующем примере кода определяется метод с именем PointFToPoint , который преобразует PointF структуру в структуру Point . Затем в примере создается массив структур PointF, создается делегат Converter<PointF, Point> (Converter(Of PointF, Point) в Visual Basic) для представления метода PointFToPoint и передает делегат в метод ConvertAll. Метод ConvertAll передает каждому элементу входного списка PointFToPoint методу и помещает преобразованные элементы в новый список Point структур. В примере pointFToPoint F# функция неявно приведение к делегату Converter<PointF, Point> . Отображаются оба списка.

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

open System
open System.Drawing
open System.Collections.Generic

let pointFToPoint (pf: PointF) =
    Point(int pf.X, int pf.Y)

// Create an array of PointF objects.
let apf =
    [| PointF(27.8f, 32.62f)
       PointF(99.3f, 147.273f)
       PointF(7.5f, 1412.2f) |]

// Display each element in the PointF array.
printfn ""
for p in apf do
    printfn $"{p}"

// Convert each PointF element to a Point object.
let ap = Array.ConvertAll(apf, pointFToPoint)
// let ap = Array.map pointFToPoint apf

// Display each element in the Point array.
printfn ""
for p in ap do
    printfn $"{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}

Imports System.Drawing
Imports System.Collections.Generic

Public Class Example
    Public Shared Sub Main()
        ' Create an array of PointF objects.
        Dim apf() As PointF = { _
            New PointF(27.8, 32.62), _
            New PointF(99.3, 147.273), _
            New PointF(7.5, 1412.2)  }

        ' Display each element in the PointF array.
        Console.WriteLine()
        For Each p As PointF In apf
            Console.WriteLine(p)
        Next
        
        ' Convert each PointF element to a Point object.
        Dim ap() As Point = Array.ConvertAll(apf, _
            New Converter(Of PointF, Point)(AddressOf PointFToPoint))

        ' Display each element in the Point array.
        Console.WriteLine()
        For Each p As Point In ap
            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
' The 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> делегат метода, который преобразует объект в целевой тип. Элементы передаются arrayотдельным элементамConverter<TInput,TOutput>, а преобразованные элементы сохраняются в новом массиве.

Источник array остается неизменным.

Этот метод является операцией O(n), где n находится Length .array

В F#функция Array.map обычно используется.

Применяется к

См. также раздел