ThinkGeo.MapSuite.SilverlightCore.ShapeFileFeatureLayer

This class represents a Layer backed by a Shape File.

• System.Object
  • ThinkGeo.MapSuite.SilverlightCore.Layer
    • ThinkGeo.MapSuite.SilverlightCore.FeatureLayer
      • ThinkGeo.MapSuite.SilverlightCore.ShapeFileFeatureLayer

ShapeFileFeatureLayer()

• This is a constructor for the class.

• This is the default constructor. If you use this constructor, then you should set the required methods manually.

ShapeFileFeatureLayer(String)

• This is a constructor for the class.

• None

• shapePathFilename
  • Type:String
  • Description:This parameter is the Shape File path and filename.

ShapeFileFeatureLayer(String,ShapeFileReadWriteMode)

• This is a constructor for the class.

• None

• shapePathFilename
  • Type:String
  • Description:This parameter is the Shape File path and filename.

• readWriteMode
  • Type:ShapeFileReadWriteMode
  • Description:This parameter specifies whether the file will be opened in read-only or read/write mode.

ShapeFileFeatureLayer(String,String)

• This is a constructor for the class.

• None

• shapePathFilename
  • Type:String
  • Description:This parameter is the Shape File path and filename.

• indexPathFilename
  • Type:String
  • Description:This parameter is the index file path and filename.

ShapeFileFeatureLayer(String,String,ShapeFileReadWriteMode)

• This is a constructor for the class.

• None

• shapePathFilename
  • Type:String
  • Description:This parameter is the Shape File path and filename.

• indexPathFilename
  • Type:String
  • Description:This parameter is the index file path and filename.

• readWriteMode
  • Type:ShapeFileReadWriteMode
  • Description:This parameter specifies whether the file will be opened in read-only or read/write mode.

ShapeFileFeatureLayer(String,String,ShapeFileReadWriteMode,Encoding)

• This is a constructor for the class.

• None

• shapePathFilename
  • Type:String
  • Description:This parameter is the Shape File path and filename.

• indexPathFilename
  • Type:String
  • Description:This parameter is the index file path and filename.

• readWriteMode
  • Type:ShapeFileReadWriteMode
  • Description:This parameter specifies whether the file will be opened in read-only or read/write mode.

• encoding
  • Type:Encoding
  • Description:This parameter specifies the encoding of the data.

GetShapeFileType()

• Get the Shape File type for the Shape File FeatureSource.

• N/A

• Type:ShapeFileType
• Description:The ShapeFileType for the ShapeFile FeatureSource.

Validate()

• This method checks all features in a shapefile is supported by Mapsuite or not.

• N/A

• Type:Dictionary<String,String>
• Description:A dictionary which contains all the unsupported features. The key is the Indexs which failed to pass the check, the value contains the reason for its failure.

GetDataFromDbf(String,String)

• N/A

• N/A

• Type:String
• Description:N/A

• id
  • Type:String
  • Description:N/A

• columnName
  • Type:String
  • Description:N/A

GetDataFromDbf(String)

• N/A

• N/A

• Type:Dictionary<String,String>
• Description:N/A

• id
  • Type:String
  • Description:N/A

GetDataFromDbf(String,IEnumerable<String>)

• N/A

• N/A

• Type:Dictionary<String,String>
• Description:N/A

• id
  • Type:String
  • Description:N/A

• returningColumnNames
  • Type:IEnumerable<String>
  • Description:N/A

GetDataFromDbf(IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Dictionary<String,String»
• Description:N/A

• ids
  • Type:IEnumerable<String>
  • Description:N/A

GetDataFromDbf(IEnumerable<String>,String)

• N/A

• N/A

• Type:Collection<Dictionary<String,String»
• Description:N/A

• ids
  • Type:IEnumerable<String>
  • Description:N/A

• columnName
  • Type:String
  • Description:N/A

GetDataFromDbf(IEnumerable<String>,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Dictionary<String,String»
• Description:N/A

• ids
  • Type:IEnumerable<String>
  • Description:N/A

• returningColumnNames
  • Type:IEnumerable<String>
  • Description:N/A

UpdateDbfData(String,String,String)

• N/A

• N/A

• Type:Void
• Description:N/A

• id
  • Type:String
  • Description:N/A

• columnName
  • Type:String
  • Description:N/A

• decimalDegreesValue
  • Type:String
  • Description:N/A

UpdateDbfData(String,IEnumerable<String>,IEnumerable<String>)

• N/A

• N/A

• Type:Void
• Description:N/A

• id
  • Type:String
  • Description:N/A

• returningColumnNames
  • Type:IEnumerable<String>
  • Description:N/A

• values
  • Type:IEnumerable<String>
  • Description:N/A

Open()

• N/A

• N/A

• Type:Void
• Description:N/A

Close()

• N/A

• N/A

• Type:Void
• Description:N/A

GetBoundingBox()

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

Draw(GeoCanvas,Collection<SimpleCandidate>)

• N/A

• N/A

• Type:Void
• Description:N/A

• canvas
  • Type:GeoCanvas
  • Description:N/A

• labelsInAllLayers
  • Type:Collection<SimpleCandidate>
  • Description:N/A

ToString()

• N/A

• N/A

• Type:String
• Description:N/A

Equals(Object)

• N/A

• N/A

• Type:Boolean
• Description:N/A

• obj
  • Type:Object
  • Description:N/A

GetHashCode()

• N/A

• N/A

• Type:Int32
• Description:N/A

GetType()

• N/A

• N/A

• Type:Type
• Description:N/A

Rebuild(String)

• This method rebuilds the SHP, SHX, DBF, IDX and IDS files for the given shape file.

• This method rebuilds the SHP, SHX, DBF, IDX and IDS files for the given shape file. When we do editing we have optimized the updates so that we do not need to rebuild the entire shape file. This leads to the shape file being out of order which may cause it not to open in other tools. One optimization is if you update a record instead of rebuilding a new shape file we mark the old record as null and add the edited record at the end of the shape file. This greatly increases the speed of committing shape file changes but will over time unorder the shape file. In addition we do a delete the DBF file will simply mark the record deleted and not compact the space. Rebuilding the shape file will correctly order the SPX and SHX along with compacting the DBF file and rebuild any index with the same any of the shape file if it exists. Note that if you have build custom index files where the name of the index differs from that of the shape file you will need to rebuild those manually using the BuildIndex methods.

• Type:Void
• Description:None

• shapePathFilename
  • Type:String
  • Description:This parameter is the shape file you want to rebuild.

CreateShapeFile(ShapeFileType,String,IEnumerable<DbfColumn>)

• Static API to create a new Shape File.

• N/A

• Type:Void
• Description:N/A

• shapeType
  • Type:ShapeFileType
  • Description:This parameter specifies the the Shape File type for the target Shape File.

• pathFilename
  • Type:String
  • Description:This parameter specifies the Shape filename for the target Shape File.

• databaseColumns
  • Type:IEnumerable<DbfColumn>
  • Description:This parameter specifies the DBF column information for the target Shape File.

CreateShapeFile(ShapeFileType,String,IEnumerable<DbfColumn>,Encoding)

• Static API to create a new Shape File.

• N/A

• Type:Void
• Description:N/A

• shapeType
  • Type:ShapeFileType
  • Description:This parameter specifies the the Shape File type for the target Shape File.

• pathFilename
  • Type:String
  • Description:This parameter specifies the Shape filename for the target Shape File.

• databaseColumns
  • Type:IEnumerable<DbfColumn>
  • Description:This parameter specifies the DBF column information for the target Shape File.

• encoding
  • Type:Encoding
  • Description:This parameter specifies the DBF encoding infromation for the target Shape File.

CreateShapeFile(ShapeFileType,String,IEnumerable<DbfColumn>,Encoding,OverwriteMode)

• Static API to create a new Shape File.

• An exception will be thown when the target Shape File does not exist while the overwrite mode is set to DoNotOverwrite.

• Type:Void
• Description:N/A

• shapeType
  • Type:ShapeFileType
  • Description:This parameter specifies the the Shape File type for the target Shape File.

• pathFilename
  • Type:String
  • Description:This parameter specifies the Shape filename for the target Shape File.

• databaseColumns
  • Type:IEnumerable<DbfColumn>
  • Description:This parameter specifies the DBF column information for the target Shape File.

• encoding
  • Type:Encoding
  • Description:This parameter specifies the DBF encoding infromation for the target Shape File.

• overwriteMode
  • Type:OverwriteMode
  • Description:This parameter specifies the override mode when the target Shape File exists.

BuildIndexFile(String)

• This method builds a spatial index for the layer.

• This overload allows you to pass in the Shape File.

• Type:Void
• Description:None

• pathFilename
  • Type:String
  • Description:The path and filename to the Shape File.

BuildIndexFile(String,String,BuildIndexMode)

• This method build a spatial index for the shape file which increases accessspeed.

• This overload builds an index file with the same name as the shape file with only the extension being different. You can also specify if you want to rebuild an existing index file.

• Type:Void
• Description:None

• shapePathFilename
  • Type:String
  • Description:This parameter is the shape file name and path that you want to build an index for.

• indexPathFilename
  • Type:String
  • Description:This parameter specifies the index file name.

• buildIndexMode
  • Type:BuildIndexMode
  • Description:This parameter determines what will happen if there is an existing index file.

BuildIndexFile(String,BuildIndexMode)

• This method builds a spatial index for the layer.

• This overload allows you to pass in the Shape File and determines if we rebuild an index file that already exists.

• Type:Void
• Description:None

• pathFilename
  • Type:String
  • Description:This parameter is the matching pattern that defines which Shape Files to include.

• rebuildExistingIndexMode
  • Type:BuildIndexMode
  • Description:This parameter determines whether an index file will be rebuilt if it already exists.

BuildIndexFile(IEnumerable<Feature>,String)

• This method builds a spatial index for the specified group of features.

• This overload allows you to pass in a group of features and specify the index filename to use.

• Type:Void
• Description:None

• features
  • Type:IEnumerable<Feature>
  • Description:This parameter specifies the features for which to build the index.

• indexPathFilename
  • Type:String
  • Description:This parameter specifies the target index path and filename.

BuildIndexFile(IEnumerable<Feature>,String,Projection)

• This method builds a spatial index for the specified group of features and target projection.

• This overload allows you to pass in a group of features and specify a target projection and the index filename to use.

• Type:Void
• Description:None

• features
  • Type:IEnumerable<Feature>
  • Description:This parameter specifies the features for which to build the index.

• indexPathFilename
  • Type:String
  • Description:This parameter specifies the target index path and filename.

• projection
  • Type:Projection
  • Description:This parameter specifies the projection to build index against those features.

BuildIndexFile(IEnumerable<Feature>,String,BuildIndexMode)

• This method builds a spatial index for the specified group of features.

• This overload allows you to pass in a group of features and specify the index filename to use.

• Type:Void
• Description:None

• features
  • Type:IEnumerable<Feature>
  • Description:This parameter specifies the features for which to build the index.

• indexPathFilename
  • Type:String
  • Description:This parameter determines the target index path filename.

• buildIndexMode
  • Type:BuildIndexMode
  • Description:This parameter determines whether an index file will be rebuilt if it already exists.

BuildIndexFile(IEnumerable<Feature>,String,Projection,BuildIndexMode)

• This method builds a spatial index for the specified group of features.

• This overload allows you to pass in a group of features and specify a target projection and the index filename to use.

• Type:Void
• Description:None

• features
  • Type:IEnumerable<Feature>
  • Description:This parameter specifies the features for which to build the index.

• indexPathFilename
  • Type:String
  • Description:This parameter determines the target index path filename.

• projection
  • Type:Projection
  • Description:This parameter determines the Projection to build index against those features.

• buildIndexMode
  • Type:BuildIndexMode
  • Description:This parameter determines whether an index file will be rebuilt if it already exists.

BuildIndexFile(String,String,String,String,BuildIndexMode)

• This method builds a spatial index only for those features that satisfy a regular expression.

• This overload allows you to pass in a Shape File and specify the index filename to use.

• Type:Void
• Description:None

• shapePathFilename
  • Type:String
  • Description:This parameter specifies the Shape File for which to build the index.

• indexPathFilename
  • Type:String
  • Description:This parameter determines the target index path filename.

• columnName
  • Type:String
  • Description:This parameter determines the column name whose values will be tested against the regular expression.

• regularExpression
  • Type:String
  • Description:This parameter represents the regular expression to test against each feature for inclusion in the index.

• buildIndexMode
  • Type:BuildIndexMode
  • Description:This parameter determines whether an index file will be rebuilt if it already exists.

BuildIndexFile(String,String,Projection,String,String,BuildIndexMode)

• This method builds a spatial index only for those features that satisfy a regular expression, based on a passed-in projection.

• This overload allows you to pass in a Shape File and specify the index filename to use.

• Type:Void
• Description:None

• shapePathFilename
  • Type:String
  • Description:This parameter specifies the Shape File for which to build the index.

• indexPathFilename
  • Type:String
  • Description:This parameter determines the target index path filename.

• projection
  • Type:Projection
  • Description:This parameter determines the projection that will be used to build the index against those features that satisfy the regular expression.

• columnName
  • Type:String
  • Description:This parameter determines the column name whose values will be tested against the regular expression.

• regularExpression
  • Type:String
  • Description:This parameter represents the regular expression to test against each feature for inclusion in the index.

• buildIndexMode
  • Type:BuildIndexMode
  • Description:This parameter determines whether an index file will be rebuilt if it already exists.

BuildIndexFile(String,String,Projection,String,String,BuildIndexMode,Encoding)

• This method builds a spatial index only for those features that satisfy a regular expression, based on a passed-in projection.

• This overload allows you to pass in a Shape File and specify the index filename to use.

• Type:Void
• Description:None

• shapePathFilename
  • Type:String
  • Description:This parameter specifies the Shape File for which to build the index.

• indexPathFilename
  • Type:String
  • Description:This parameter determines the target index path filename.

• projection
  • Type:Projection
  • Description:This parameter determines the projection that will be used to build the index against those features that satisfy the regular expression.

• columnName
  • Type:String
  • Description:This parameter determines the column name whose values will be tested against the regular expression.

• regularExpression
  • Type:String
  • Description:This parameter represents the regular expression to test against each feature for inclusion in the index.

• buildIndexMode
  • Type:BuildIndexMode
  • Description:This parameter determines whether an index file will be rebuilt if it already exists.

• encoding
  • Type:Encoding
  • Description:This parameter specifies the encoding information used in the source DBF file.

CloneShapeFileStructure(String,String)

• Clone the structure from the source ShapeFile to the target ShapeFile. After cloning the structure, the target ShapeFile will have the same type and the same DBF columns as the source ShapeFile, but without any records in it.

• N/A

• Type:Void
• Description:N/A

• sourceShapePathFilename
  • Type:String
  • Description:The source Shape File to be cloned.

• targetShapePathFilename
  • Type:String
  • Description:The target Shape File, which will have the same structure as the source Shape File after cloning operation is complete.

CloneShapeFileStructure(String,String,OverwriteMode)

• Clone the structure from the source ShapeFile to the target ShapeFile. After cloning the structure, the target ShapeFile will have the same type and the same DBF columns as the source ShapeFile, but without any records in it.

• An exception will be thown when the target ShapeFile does not exist and the overwrite mode is set to DoNotOverwrite.

• Type:Void
• Description:N/A

• sourceShapePathFilename
  • Type:String
  • Description:The source Shape File to be cloned.

• targetShapePathFilename
  • Type:String
  • Description:The target Shape File, which will have the same structure as the source Shape File after cloning operation is complete.

• overwriteMode
  • Type:OverwriteMode
  • Description:This parameter specifies the overwrite mode when the target ShapeFile already exists.

CloneShapeFileStructure(String,String,OverwriteMode,Encoding)

• Clone the structure from the source ShapeFile to the target ShapeFile. After cloning the structure, the target ShapeFile will have the same type and the same DBF columns as the source ShapeFile, but without any records in it.

• An exception will be thown when the target ShapeFile does not exist and the overwrite mode is set to DoNotOverwrite.

• Type:Void
• Description:N/A

• sourceShapePathFilename
  • Type:String
  • Description:The source Shape File to be cloned.

• targetShapePathFilename
  • Type:String
  • Description:The target Shape File, which will have the same structure as the source Shape File after cloning operation is complete.

• overwriteMode
  • Type:OverwriteMode
  • Description:This parameter specifies the overwrite mode when the target ShapeFile already exists.

• encoding
  • Type:Encoding
  • Description:This parameter specifies the encoding information in the source Shape File.

BuildRecordIdColumn(String,String,BuildRecordIdMode)

• Static API used to build RecordId. The Id will start from 0.

• N/A

• Type:Void
• Description:N/A

• shapeFilename
  • Type:String
  • Description:The name of the target ShapeFile on which to base the newly built RecordId.

• fieldname
  • Type:String
  • Description:The field name for the RecordId.

• rebuildNeeded
  • Type:BuildRecordIdMode
  • Description:The RecordId build mode.

BuildRecordIdColumn(String,String,BuildRecordIdMode,Int32)

• Static API used to build RecordId from the specified starting Id number.

• N/A

• Type:Void
• Description:N/A

• shapeFilename
  • Type:String
  • Description:The name of the target ShapeFile on which to base the newly built RecordId.

• fieldname
  • Type:String
  • Description:The field name for the RecordId.

• rebuildNeeded
  • Type:BuildRecordIdMode
  • Description:The RecordId build mode.

• startNumber
  • Type:Int32
  • Description:The starting Id number of the RecordId.

BuildRecordIdColumn(String,String,BuildRecordIdMode,Int32,Encoding)

• Static API used to build RecordId from the specified starting Id number.

• N/A

• Type:Void
• Description:N/A

• shapeFilename
  • Type:String
  • Description:The name of the target ShapeFile on which to base the newly built RecordId.

• fieldname
  • Type:String
  • Description:The field name for the RecordId.

• rebuildNeeded
  • Type:BuildRecordIdMode
  • Description:The RecordId build mode.

• startNumber
  • Type:Int32
  • Description:The starting Id number of the RecordId.

• encoding
  • Type:Encoding
  • Description:This parameter specifies the encoding information in the DBF.

SaveToProjection(String,String,Projection,OverwriteMode)

• This API provide a easy way to project features in a shape file into another projection and save it to shape file.

• N/A

• Type:Void
• Description:N/A

• sourceShapeFile
  • Type:String
  • Description:This parameter specifies the source shape file to be projected.

• targetShapeFile
  • Type:String
  • Description:This parameter specifies the target shape file to be saved for the projected features.

• projection
  • Type:Projection
  • Description:This parameter is the projection to project the source shape file to target shape file. The source Shape file should be in the FromProjection of the Projection prameter, and the targetShapeFile will be in the ToProjection of the Projection.

• overwriteMode
  • Type:OverwriteMode
  • Description:This parameter specifies the override mode when the target shape file exists.

OnDrawingFeatures(DrawingFeaturesEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

• e
  • Type:DrawingFeaturesEventArgs
  • Description:N/A

OnDrawingWrappingFeatures(DrawingWrappingFeaturesFeatureLayerEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

• e
  • Type:DrawingWrappingFeaturesFeatureLayerEventArgs
  • Description:N/A

SetupTools()

• N/A

• N/A

• Type:Void
• Description:N/A

SetupToolsCore()

• N/A

• N/A

• Type:Void
• Description:N/A

OpenCore()

• N/A

• N/A

• Type:Void
• Description:N/A

CloseCore()

• N/A

• N/A

• Type:Void
• Description:N/A

GetBoundingBoxCore()

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

DrawCore(GeoCanvas,Collection<SimpleCandidate>)

• N/A

• N/A

• Type:Void
• Description:N/A

• canvas
  • Type:GeoCanvas
  • Description:N/A

• labelsInAllLayers
  • Type:Collection<SimpleCandidate>
  • Description:N/A

DrawException(GeoCanvas,Exception)

• N/A

• N/A

• Type:Void
• Description:N/A

• canvas
  • Type:GeoCanvas
  • Description:N/A

• e
  • Type:Exception
  • Description:N/A

DrawExceptionCore(GeoCanvas,Exception)

• N/A

• N/A

• Type:Void
• Description:N/A

• canvas
  • Type:GeoCanvas
  • Description:N/A

• e
  • Type:Exception
  • Description:N/A

OnDrawingProgressChanged(DrawingProgressChangedEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

• e
  • Type:DrawingProgressChangedEventArgs
  • Description:N/A

Finalize()

• N/A

• N/A

• Type:Void
• Description:N/A

MemberwiseClone()

• N/A

• N/A

• Type:Object
• Description:N/A

HasBoundingBox

This property checks to see if a Layer has a BoundingBox or not. If it has no BoundingBox, it will throw an exception when you call the GetBoundingBox() and GetFullExtent() APIs. In ShapeFileFeatureLayer, we override this API and mark it as true.

The default implementation in the base class returns false.

• Type:Boolean

UsingSpatialIndex

This property gets whether the Shape File FeatureSource has an index or not.

N/A

• Type:Boolean

Encoding

This property gets and sets the encoding information for the DBF.

N/A

• Type:Encoding

ShapePathFileName

This property returns the path and filename of the Shape File you want to represent.

None

• Type:String

IndexPathFileName

This property returns the path and filename of the index file you want to represent.

None

• Type:String

ReadWriteMode

N/A

N/A

• Type:ShapeFileReadWriteMode

RequireIndex

This property gets and sets whether an index is required when reading data. The default value is true.

N/A

• Type:Boolean

MaxRecordsToDraw

N/A

N/A

• Type:Int32

WrappingExtent

N/A

N/A

• Type:RectangleShape

WrappingMode

N/A

N/A

• Type:WrappingMode

EditTools

N/A

N/A

• Type:EditTools

FeatureIdsToExclude

N/A

N/A

• Type:Collection<String>

QueryTools

N/A

N/A

• Type:QueryTools

FeatureSource

N/A

N/A

• Type:FeatureSource

ZoomLevelSet

N/A

N/A

• Type:ZoomLevelSet

DrawingMarginPercentage

N/A

N/A

• Type:Double

IsOpen

N/A

N/A

• Type:Boolean

DrawingTime

N/A

N/A

• Type:TimeSpan

Name

N/A

N/A

• Type:String

IsVisible

N/A

N/A

• Type:Boolean

DrawingExceptionMode

N/A

N/A

• Type:DrawingExceptionMode

IsOpenCore

N/A

N/A

• Type:Boolean

StreamLoading This event allows you to pass in your own stream to represent the files.

If you choose you can pass in your own stream to represent the file. The stream can come from a variety of places such as isolated storage, a compressed file, and encrypted stream. When the Image is finished with the stream it will dispose of it so be sure to keep this in mind when passing the stream in. If you do not pass in a alternate stream the class will attempt to load the file from the file system using the PathFileName property.

Event Arguments:StreamLoadingEventArgs

DrawingFeatures N/A

N/A

Event Arguments:DrawingFeaturesEventArgs

DrawingWrappingFeatures N/A

N/A

Event Arguments:DrawingWrappingFeaturesFeatureLayerEventArgs

DrawingProgressChanged N/A

N/A

Event Arguments:DrawingProgressChangedEventArgs