Array.ConvertAll<TInput,TOutput> Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Converte uma matriz de um tipo para uma matriz de outro tipo.
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()Parâmetros de tipo
- TInput
O tipo dos elementos da matriz de origem.
- TOutput
O tipo dos elementos da matriz de destino.
Parâmetros
- array
- TInput[]
O Array unidimensional baseado em zero para converter para um tipo de destino.
- converter
- Converter<TInput,TOutput>
Um Converter<TInput,TOutput> que converte cada elemento de um tipo em outro tipo.
Retornos
- TOutput[]
Uma matriz do tipo de destino que contém os elementos convertidos da matriz de origem.
Exceções
Exemplos
O exemplo de código a seguir define um método chamado PointFToPoint que converte uma PointF estrutura em uma Point estrutura. Em seguida, o exemplo cria uma matriz de PointF estruturas, cria um Converter<PointF, Point> delegado (Converter(Of PointF, Point)em Visual Basic) para representar o PointFToPoint método e passa o delegado para o ConvertAll método. O ConvertAll método passa cada elemento da lista de entrada para o PointFToPoint método e coloca os elementos convertidos em uma nova lista de Point estruturas. No exemplo F#, a pointFToPoint função é implicitamente convertida no Converter<PointF, Point> delegado. Ambas as listas são exibidas.
#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()
{
// Create an array of PointF objects.
array<PointF>^ apf = {
PointF(27.8F, 32.62F),
PointF(99.3F, 147.273F),
PointF(7.5F, 1412.2F) };
// Display each element in the PointF array.
Console::WriteLine();
for each(PointF p in apf)
{
Console::WriteLine(p);
}
// Convert each PointF element to a Point object.
array<Point>^ ap =
Array::ConvertAll(apf,
gcnew Converter<PointF, Point>(PointFToPoint)
);
// Display each element in the Point array.
Console::WriteLine();
for each(Point p in ap)
{
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()
{
// 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}
Comentários
O Converter<TInput,TOutput> é um delegado para um método que converte um objeto no tipo de destino. Os elementos são array passados individualmente para o Converter<TInput,TOutput>, e os elementos convertidos são salvos na nova matriz.
A origem array permanece inalterada.
Este método é uma operação O(n), em que n é o Length de array.
Em F#, a função Array.map geralmente é usada.