Public Overloads Shared Function Project( _
   ByVal geometries As GeometryCollection, _
   ByVal toSpatialReference As SpatialReference, _
   ByVal densifyTolerance As Double, _
   ByVal accuracy As Double, _
   ByVal returnEnvelopes As Boolean, _
   ByVal connection As ESRI.ArcGIS.ADF.Connection.IMS.IMSServerConnection, _
   ByVal environment As Environment _
) As GeometryCollection

Visual Basic (Usage)

Copy Code

Dim geometries As GeometryCollection Dim toSpatialReference As SpatialReference Dim densifyTolerance As Double Dim accuracy As Double Dim returnEnvelopes As Boolean Dim connection As ESRI.ArcGIS.ADF.Connection.IMS.IMSServerConnection Dim environment As Environment Dim value As GeometryCollection   value = Projection.Project(geometries, toSpatialReference, densifyTolerance, accuracy, returnEnvelopes, connection, environment)

public static GeometryCollection Project( 
   GeometryCollection geometries,
   SpatialReference toSpatialReference,
   double densifyTolerance,
   double accuracy,
   bool returnEnvelopes,
   ESRI.ArcGIS.ADF.Connection.IMS.IMSServerConnection connection,
   Environment environment
)

Parameters

geometries

The GeometryCollection to project.

toSpatialReference

SpatialReference to project the Geometries to.

densifyTolerance

Defines the distance (tolerance) between points and is applied on the Geometry before the projection takes place.

accuracy

Determines the amount of generalization for a feature based on a specified distance.

returnEnvelopes

True to return the projected Geometries as envelopes.

connection

IMSServerConnection for the projection request.

environment

The Environment for the request, which provides culture information.

Return Value

Accuracy

Points are generalized within a feature based on the distance specified and the resolution of the image. Units are the same as the service. A value of 0 for accuracy returns all points of a feature, whereas higher values return a feature with fewer points thus making the feature more generalized. Note that given a non-zero value used for accuracy, and depending on the geometry layout of features in a layer, polylines or polygons may become self-intersecting. When this happens, the geomtery is invalid, the feature is ignored, and no result is returned for the spatial query. Accuracy cannot be used on a point layer; only polygon and polyline layers are valid.

DensifyTolerance

Defines the distance (tolerance) between points and is applied on the geometry before projecting takes place. The units are the same as the units for the original coordinate system. For example, if the coordinate system is in feet, the densifyTolerance distance is in feet.

The process of data densification adds virtual points to a polygon before it is projected. When a polygon is projected, the line geometry changes. For example, a square in one projection may be trapezoidal in another projection. In some cases, the number of points defining the geometry in the original geometry is not enough to describe the geometry correctly in the new coordinate system.

If the tolerance value is too small, the ArcIMS Spatial Server can slow down considerably. It is better to start with a large value. A guideline is to start with a value about 20 to 30 percent of the distance between the minimum and maximum x-coordinates of the current map extent.

ReturnEnvelopes

When returnEnvelopes is set to true, geometry is returned as Envelope. When set to false, the input and output geometry are the same. The exception is when using Envelope as input geometry. In this case, when returnEnvelopes is false, then the geometry is returned as Polygon.

Environment

The Environment parameter is used to determine the culture information for writing out the geometry in the request. An Environment object may be constructed by reading the machine information, which loads the current culture information from the server.

Returned Geometry

The returned value will be a GeometryCollection. You may need to cast the members of the collection to the appropriate type to display or use them. See above on returnEnvelopes for whether the returned geometry will be the same as the input type or Envelope.

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

Reference