Projects an array of geometries from their current spatial reference to a destination spatial reference.
Project(SpatialReference InSpatialReference, SpatialReference OutSpatialReference, bool TransformForward, GeoTransformation Transformation, Envelope Extent, Geometry[] InGeometryArray)
|
Parameter |
Description |
|
InSpatialReference |
The spatial reference of the geometries in the InGeometryArray. The current spatial reference. This cannot be null. |
|
OutSpatialReference |
The spatial reference of the geometry returned from the project operation. The destination spatial reference. This cannot be null. |
|
TransformForward |
Indicates whether to transform forward (true) or not (false). Optional. |
|
Transformation |
An instance of a GeoTransformation must also specify forward or reverse. Optional. For a list of valid WKID codes for transformations, see the discussion Finding a Well-Known ID. |
|
Extent |
An extent Envelope which will optimize the projection operation by checking if the Envelope is completely contained in the horizon. Optional. |
|
InGeometryArray |
The array of Geometry to be buffered by each distance in the array Distances. All geometries are assumed to be in the coordinate system InSpatialReference. |
Return Value
An array of Geometry (Geometry[]).
Remarks
This method applies the projection defined
in OutSpatialReference to a copy
of each element of InGeometryArray
and places the result in an output geometry array. All inputs are assumed
to be in the spatial reference of InSpatialReference.
The input geometries are not modified. The input array can contain mixed
top-level geometry types.
The SpatialReference property for all returned geometry will be
null. It is the consumers responsibility to assign the spatial
reference to each geometry returned, if desired. In this case, the spatial
reference is assumed to be the output spatial reference defined for the
Project operation.
If Transformation
is not specified, a search is made through a set of default geotransformations.
Currently, the following transformations are in that set:
esriSRGeoTransformation_NAD_1927_TO_NAD_1983_NADCON, forward and reverse, WKID=1241
esriSRGeoTransformation_NAD1983_To_WGS1984_1, forward and reverse, WKID=1188
esriSRGeoTransformation_NAD1927_To_WGS1984_4,
forward and reverse, WKID=1173
For a complete list of EPSG or ESRI WKIDs for spatial references and
transformations, see the discussion Finding
a Well-Known ID
Examples