Array.ConvertAll<'TInput, 'TOutput> Method ('TInput[], Converter<'TInput, 'TOutput>)
Converts an array of one type to an array of another type.
Assembly: mscorlib (in mscorlib.dll)
static member ConvertAll<'TInput, 'TOutput> : array:'TInput[] * converter:Converter<'TInput, 'TOutput> -> 'TOutput[]
Parameters
- array
-
Type:
'TInput[]
The one-dimensional, zero-based Array to convert to a target type.
- converter
-
Type:
System.Converter<'TInput, 'TOutput>
A Converter<'TInput, 'TOutput> that converts each element from one type to another type.
Return Value
Type: 'TOutput[]An array of the target type containing the converted elements from the source array.
Type Parameters
- TInput
The type of the elements of the source array.
- TOutput
The type of the elements of the target array.
| Exception | Condition |
|---|---|
| ArgumentNullException | array is null. -or- converter is null. |
The Converter<'TInput, 'TOutput> is a delegate to a method that converts an object to the target type. The elements of array are individually passed to the Converter<'TInput, 'TOutput>, and the converted elements are saved in the new array.
The source array remains unchanged.
This method is an O(n) operation, where n is the Length of array.
The following code example defines a method named PointFToPoint that converts a PointF structure to a Point structure. The example then creates an array of PointF structures, creates a Converter<PointF, Point> delegate (Converter(Of PointF, Point) in Visual Basic) to represent the PointFToPoint method, and passes the delegate to the ConvertAll<'TInput, 'TOutput> method. The ConvertAll<'TInput, 'TOutput> method passes each element of the input list to the PointFToPoint method and puts the converted elements into a new list of Point structures. Both lists are displayed.
Available since 2.0