ArcObjects Library Reference (Geometry)

ISpatialReference Interface

Provides access to members that control a SpatialReference. Note: the ISpatialReference interface has been superseded byISpatialReference3. Please consider using the more recent version.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Description

The spatial reference is not defined when creating a new instance of a geometry. It is the developer's responsibility to define a spatial reference that makes sense for the geometry and for the operation. To achieve precise and predictable results using the geometry library, it is essential that the spatial reference of geometries within a workflow is well defined. When performing a spatial operation using two or more geometries, for example an intersection, the coordinate systems of the two geometries must be equal. If the coordinate systems of the geometries are different or undefined, the operation could produce unexpected results.

Members

		Description
	Abbreviation	The abbreviated name of this spatial reference component.
	Alias	The alias of this spatial reference component.
	Changed	Notify this object that some of its parts have changed (parameter values, z unit, etc.).
	FactoryCode	The factory code (WKID) of the spatial reference.
	GetDomain	The XY domain extent.
	GetFalseOriginAndUnits	Get the false origin and units.
	GetMDomain	The measure domain extent.
	GetMFalseOriginAndUnits	Get the measure false origin and units.
	GetZDomain	The Z domain extent.
	GetZFalseOriginAndUnits	Get the Z false origin and units.
	HasMPrecision	Returns true when m-value precision information has been defined.
	HasXYPrecision	Returns true when (x,y) precision information has been defined.
	HasZPrecision	Returns true when z-value precision information has been defined.
	IsPrecisionEqual	Returns TRUE when the precision information for the two spatial references is the same.
	Name	The name of this spatial reference component.
	Remarks	The comment string of this spatial reference component.
	SetDomain	The XY domain extent.
	SetFalseOriginAndUnits	Set the false origin and units.
	SetMDomain	The measure domain extent.
	SetMFalseOriginAndUnits	Set the measure false origin and units.
	SetZDomain	The Z domain extent.
	SetZFalseOriginAndUnits	Set the Z false origin and units.
	ZCoordinateUnit	The unit for the Z coordinate.

Inherited Interfaces

Interfaces	Description
ISpatialReferenceInfo	Provides access to members that control the properties common to all components of a spatial reference system.

CoClasses that implement ISpatialReference

CoClasses and Classes	Description
GeographicCoordinateSystem	Creates a geographic coordinate system.
ProjectedCoordinateSystem	Creates a projected coordinate system.
UnknownCoordinateSystem	Creates an unknown coordinate system.

[C#]

The following code demonstrates how to compare two spatial references. There are two ways shown in the example one using IClone and the other using ICompareSpatialReferences and the IsEqualNoVCS method

        public static bool CompareSpatialRefs(ISpatialReference sourceSR, ISpatialReference targetSR)
        {
            IClone sClone=sourceSR as IClone;
            IClone tClone=targetSR as IClone;

            // first level test compares the coordinate system component
            if (!sClone.IsEqual(tClone))
                return false;

            return true;
        }

.NET Snippets

.NET Samples

Curve conversion add-in (Code Files: CurveConversionDockWin) | Implementing a schematic layout algorithm and its layout property page (Code Files: TranslateTree) | Custom map selection commands (Code Files: SelectFeatures) | Create a custom raster type (Code Files: TestThumbnailBuilder) | Create a raster catalog using the geoprocessor (Code Files: CreateRasterCatalog_GP) | Create a custom raster type from the ground up for DMCII data (Code Files: DMCIIRasterType TestDMCIIRasterType) | Implementing a schematic digitizing tool (Code Files: DigitTool) | Find the closest intersection from a point (Code Files: FindClosestIntersection) | RSS weather GraphicTracker (Code Files: RSSWeather) | Move a graphic along a path in ArcMap (Code Files: AnimationUtils) | Create a Mosaic dataset (Code Files: CreateMosaicDataset) | Creating a toolbar of globe tools (Code Files: PointGeometry PolygonGeometry PolylineGeometry SpatialReference) | StreetMap routing (Code Files: RoutingForm) | RSS weather layer (Code Files: AddWeatherItemTool RSSWeatherLayerClass) | Triangle graphic element (Code Files: TriangleElementClass) | Clonable object (Code Files: ClonableObjClass TestClass) | Create camera flyby from path (Code Files: frmCameraPath) | Reducing schematic nodes and computing a cumulative attribute via a schematic rule (Code Files: NodeReductionRule)

.NET Related Topics