Array.ConvertAll<TInput,TOutput> Methode

Definitie

Naamruimte:
System
Assembly's:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Bron:
Array.cs
Bron:
Array.cs
Bron:
Array.cs
Bron:
Array.cs
Bron:
Array.cs

Converteert een matrix van het ene type naar een matrix van een ander type.

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()

Type parameters

TInput

Het type elementen van de bronmatrix.

TOutput

Het type van de elementen van de doelmatrix.

Parameters

array
TInput[]

De eendimensionale, op nul gebaseerde Array conversie naar een doeltype.

converter
Converter<TInput,TOutput>

Een Converter<TInput,TOutput> element dat elk element van het ene type naar een ander type converteert.

Retouren

TOutput[]

Een matrix van het doeltype met de geconverteerde elementen uit de bronmatrix.

Uitzonderingen

ArgumentNullException

array is null.

– of –

converter is null.

Voorbeelden

In het volgende codevoorbeeld wordt een methode gedefinieerd die PointFToPoint een PointF structuur converteert naar een Point structuur. Het voorbeeld maakt vervolgens een matrix van PointF structuren, maakt een Converter<PointF, Point> gedelegeerde (Converter(Of PointF, Point) in Visual Basic) om de methode PointFToPoint weer te geven en geeft de gemachtigde door aan de methode ConvertAll. De ConvertAll methode geeft elk element van de invoerlijst door aan de PointFToPoint methode en plaatst de geconverteerde elementen in een nieuwe lijst Point met structuren. In het F#-voorbeeld wordt de pointFToPoint functie impliciet omgezet naar de Converter<PointF, Point> gemachtigde. Beide lijsten worden weergegeven.

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}

Opmerkingen

Dit Converter<TInput,TOutput> is een gemachtigde naar een methode waarmee een object wordt geconverteerd naar het doeltype. De elementen van array worden afzonderlijk doorgegeven aan de Converter<TInput,TOutput>en de geconverteerde elementen worden opgeslagen in de nieuwe matrix.

De bron array blijft ongewijzigd.

Deze methode is een O(n)-bewerking, waarbij n de Length van array.

In F# wordt de functie Array.map over het algemeen gebruikt.

Van toepassing op

Zie ook