ThinkGeo.MapSuite.Layers.OracleFeatureSource

• System.Object
  • ThinkGeo.MapSuite.Layers.FeatureSource
    • ThinkGeo.MapSuite.Layers.OracleFeatureSource

OracleFeatureSource()

• This is the constructor for the class.

• N/A

OracleFeatureSource(String,String,String)

• This is the constructor for the class.

• None

• connectionString
  • Type:String
  • Description:This parameter represents the connection string to connect to the server.

• tableName
  • Type:String
  • Description:This parameter represents the table name being accessed.

• featureIdColumn
  • Type:String
  • Description:This parameter represents the name of the column that holds the unique feature Id.

OracleFeatureSource(String,String,String,DatabaseConnectionMode)

• N/A

• N/A

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

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

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

• databaseConnectionMode
  • Type:DatabaseConnectionMode
  • Description:N/A

BuildIndex()

• N/A

• N/A

• Type:Void
• Description:N/A

BuildIndex(BuildIndexMode)

• N/A

• N/A

• Type:Void
• Description:N/A

• mode
  • Type:BuildIndexMode
  • Description:N/A

CanGetBoundingBoxQuickly()

• N/A

• N/A

• Type:Boolean
• Description:N/A

CanGetCountQuickly()

• N/A

• N/A

• Type:Boolean
• Description:N/A

GetDistinctColumnValues(String)

• N/A

• N/A

• Type:Collection<DistinctColumnValue>
• Description:N/A

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

GetAllFeatures(ReturningColumnsType,Int32)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• returningColumnTypes
  • Type:ReturningColumnsType
  • Description:N/A

• startIndex
  • Type:Int32
  • Description:N/A

GetAllFeatures(ReturningColumnsType,Int32,Int32)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• returningColumnTypes
  • Type:ReturningColumnsType
  • Description:N/A

• startIndex
  • Type:Int32
  • Description:N/A

• takeCount
  • Type:Int32
  • Description:N/A

GetAllFeatures(IEnumerable<String>,Int32,Int32)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

• startIndex
  • Type:Int32
  • Description:N/A

• takeCount
  • Type:Int32
  • Description:N/A

RollbackTransaction()

• N/A

• N/A

• Type:Void
• Description:N/A

CommitTransaction()

• N/A

• N/A

• Type:TransactionResult
• Description:N/A

AddColumn(FeatureSourceColumn)

• N/A

• N/A

• Type:Void
• Description:N/A

• featureSourceColumn
  • Type:FeatureSourceColumn
  • Description:N/A

DeleteColumn(String)

• N/A

• N/A

• Type:Void
• Description:N/A

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

UpdateColumn(String,FeatureSourceColumn)

• N/A

• N/A

• Type:Void
• Description:N/A

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

• newFeatureSourceColumn
  • Type:FeatureSourceColumn
  • Description:N/A

GetAllFeatures(IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

GetAllFeatures(ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesOutsideBoundingBox(RectangleShape,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

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

GetFeaturesOutsideBoundingBox(RectangleShape,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesInsideBoundingBox(RectangleShape,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

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

GetFeaturesInsideBoundingBox(RectangleShape,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeatureIdsInsideBoundingBox(RectangleShape)

• N/A

• N/A

• Type:Collection<String>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

GetFeaturesForDrawing(RectangleShape,Double,Double,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

• screenWidth
  • Type:Double
  • Description:N/A

• screenHeight
  • Type:Double
  • Description:N/A

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

GetFeaturesForDrawing(RectangleShape,Double,Double,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

• screenWidth
  • Type:Double
  • Description:N/A

• screenHeight
  • Type:Double
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

SpatialQuery(BaseShape,QueryType,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• queryType
  • Type:QueryType
  • Description:N/A

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

SpatialQuery(BaseShape,QueryType,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• queryType
  • Type:QueryType
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

SpatialQuery(Feature,QueryType,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• feature
  • Type:Feature
  • Description:N/A

• queryType
  • Type:QueryType
  • Description:N/A

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

SpatialQuery(Feature,QueryType,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• feature
  • Type:Feature
  • Description:N/A

• queryType
  • Type:QueryType
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesNearestTo(BaseShape,GeographyUnit,Int32,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• unitOfFeatureSource
  • Type:GeographyUnit
  • Description:N/A

• maxItemsToFind
  • Type:Int32
  • Description:N/A

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

GetFeaturesNearestTo(BaseShape,GeographyUnit,Int32,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• maxItemsToFind
  • Type:Int32
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesNearestTo(Feature,GeographyUnit,Int32,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetFeature
  • Type:Feature
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• maxItemsToFind
  • Type:Int32
  • Description:N/A

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

GetFeaturesNearestTo(Feature,GeographyUnit,Int32,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetFeature
  • Type:Feature
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• maxItemsToFind
  • Type:Int32
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesNearestTo(BaseShape,GeographyUnit,Int32,IEnumerable<String>,Double,DistanceUnit)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• maxItemsToFind
  • Type:Int32
  • Description:N/A

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

• searchRadius
  • Type:Double
  • Description:N/A

• unitOfSearchRadius
  • Type:DistanceUnit
  • Description:N/A

GetFeaturesNearestTo(Feature,GeographyUnit,Int32,IEnumerable<String>,Double,DistanceUnit)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetFeature
  • Type:Feature
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• maxItemsToFind
  • Type:Int32
  • Description:N/A

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

• searchRadius
  • Type:Double
  • Description:N/A

• unitOfSearchRadius
  • Type:DistanceUnit
  • Description:N/A

GetFeaturesWithinDistanceOf(BaseShape,GeographyUnit,DistanceUnit,Double,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• distanceUnit
  • Type:DistanceUnit
  • Description:N/A

• distance
  • Type:Double
  • Description:N/A

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

GetFeaturesWithinDistanceOf(BaseShape,GeographyUnit,DistanceUnit,Double,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• distanceUnit
  • Type:DistanceUnit
  • Description:N/A

• distance
  • Type:Double
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesWithinDistanceOf(Feature,GeographyUnit,DistanceUnit,Double,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetFeature
  • Type:Feature
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• distanceUnit
  • Type:DistanceUnit
  • Description:N/A

• distance
  • Type:Double
  • Description:N/A

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

GetFeaturesWithinDistanceOf(Feature,GeographyUnit,DistanceUnit,Double,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetFeature
  • Type:Feature
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• distanceUnit
  • Type:DistanceUnit
  • Description:N/A

• distance
  • Type:Double
  • Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeatureById(String,IEnumerable<String>)

• N/A

• N/A

• Type:Feature
• Description:N/A

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

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

GetFeatureById(String,ReturningColumnsType)

• N/A

• N/A

• Type:Feature
• Description:N/A

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

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesByIds(IEnumerable<String>,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

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

GetFeaturesByIds(IEnumerable<String>,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

GetBoundingBoxById(String)

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

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

GetBoundingBoxByIds(IEnumerable<String>)

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

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

RemoveEmptyAndExcludedFeatures(Collection<Feature>)

• N/A

• N/A

• Type:Void
• Description:N/A

• features
  • Type:Collection<Feature>
  • Description:N/A

GetColumnNamesOutsideFeatureSource(IEnumerable<String>)

• N/A

• N/A

• Type:Collection<String>
• Description:N/A

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

GetBoundingBoxesByIds(IEnumerable<String>)

• N/A

• N/A

• Type:Collection<RectangleShape>
• Description:N/A

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

GetFirstFeaturesWellKnownType()

• N/A

• N/A

• Type:WellKnownType
• Description:N/A

ExecuteNonQuery(String)

• N/A

• N/A

• Type:Int32
• Description:N/A

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

GetFeaturesByColumnValue(String,String,ReturningColumnsType)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

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

• returningColumnType
  • Type:ReturningColumnsType
  • Description:N/A

GetFeaturesByColumnValue(String,String,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

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

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

GetFeaturesByColumnValue(String,String)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

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

ExecuteScalar(String)

• N/A

• N/A

• Type:Object
• Description:N/A

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

ExecuteQuery(String)

• N/A

• N/A

• Type:GeoDataTable
• Description:N/A

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

GetColumns()

• N/A

• N/A

• Type:Collection<FeatureSourceColumn>
• Description:N/A

RefreshColumns()

• N/A

• N/A

• Type:Void
• Description:N/A

GetCount()

• N/A

• N/A

• Type:Int32
• Description:N/A

GetBoundingBox()

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

CloneDeep()

• N/A

• N/A

• Type:FeatureSource
• Description:N/A

Open()

• N/A

• N/A

• Type:Void
• Description:N/A

Close()

• N/A

• N/A

• Type:Void
• Description:N/A

BeginTransaction()

• N/A

• N/A

• Type:Void
• Description:N/A

AddFeature(Feature)

• N/A

• N/A

• Type:String
• Description:N/A

• feature
  • Type:Feature
  • Description:N/A

AddFeature(BaseShape)

• N/A

• N/A

• Type:String
• Description:N/A

• shape
  • Type:BaseShape
  • Description:N/A

AddFeature(BaseShape,IDictionary<String,String>)

• N/A

• N/A

• Type:String
• Description:N/A

• shape
  • Type:BaseShape
  • Description:N/A

• columnValues
  • Type:IDictionary<String,String>
  • Description:N/A

DeleteFeature(String)

• N/A

• N/A

• Type:Void
• Description:N/A

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

UpdateFeature(Feature)

• N/A

• N/A

• Type:Void
• Description:N/A

• feature
  • Type:Feature
  • Description:N/A

UpdateFeature(BaseShape)

• N/A

• N/A

• Type:Void
• Description:N/A

• shape
  • Type:BaseShape
  • Description:N/A

UpdateFeature(BaseShape,IDictionary<String,String>)

• N/A

• N/A

• Type:Void
• Description:N/A

• shape
  • Type:BaseShape
  • Description:N/A

• columnValues
  • Type:IDictionary<String,String>
  • 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

CanGetBoundingBoxQuicklyCore()

• N/A

• N/A

• Type:Boolean
• Description:N/A

GetFirstFeaturesWellKnownTypeCore()

• N/A

• N/A

• Type:WellKnownType
• Description:N/A

ExecuteNonQueryCore(String)

• N/A

• You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure of a database or creating database objects such as tables), or to change the data in a database by executing UPDATE, INSERT, or DELETE statements. Although ExecuteNonQuery does not return any rows, any output parameters or return values mapped to parameters are populated with data. For UPDATE, INSERT, and DELETE statements, the return value is the number of rows affected by the command.

• Type:Int32
• Description:The number of rows affected.

• sqlStatement
  • Type:String
  • Description:The sqlStatement to be excuted.

ExecuteQueryCore(String)

• N/A

• Use the ExcuteScalar method to retrieve a single value from the database. This reaquires less code than use the ExcuteQuery method and performing the operations necessary to generate the single value using the data.

• Type:GeoDataTable
• Description:The result set in the format of dataTable.

• sqlStatement
  • Type:String
  • Description:The sqlStatement to be excuted.

ExecuteScalarCore(String)

• N/A

• Use the ExcuteScalar method to retrieve a single value from the database. This reaquires less code than use the ExcuteQuery method and performing the operations necessary to generate the single value using the data.

• Type:Object
• Description:The first column of the first row in the result set.

• sqlStatement
  • Type:String
  • Description:The sqlStatement to be excuted.

OpenCore()

• N/A

• This protected virtual method is called from the concreate public method Open. The open method play an important role as it is responsible for initializing the FeatureSource. Most methods on the FeatureSource will throw an exception if the state of the FeatureSource is not opened. When the map draws each layer it will open the FeatureSource as one of its first steps, then after it is finished drawing with that layer it will close it. In this way we are sure to release all resources used by the FeatureSource. When implementing this abstract method consider opening files for file based source, connecting to databases in the database based sources and so on. You will get a chance to close these in the Close method of the FeatureSource.

• Type:Void
• Description:None

CloseCore()

• N/A

• This protected virtual method is called from the concreate public method Close. The close method plays an important role in the life cycle of the FeatureSource. It may be called after drawing to release any memory and other resources that were allocated since the Open method was called. It is recommended that if you override this method that you take the following things into account. This method may be called multiple times so we suggest you write the so that that a call to a closed FeatureSource is ignored and does not generate an error. We also suggest that in the close you free all resources that have been opened. Remember that the object will not be destroyed but will be re-opened possibly in the near future.

• Type:Void
• Description:None

GetCountCore()

• N/A

• This protected virtual method is called from the concreate public method GetCount. It does not take into account any transaction activity as this is the responsibility of the concreate public method GetCount. In this way as a developer if you choose to override this method you do not have to consider transaction at all. The default implementation of GetCountCore uses the GetAllRecordsCore method to calculate how many records there are in the FeatureSource. We strongly recommend that you provide your own implementation for this method that will be more efficient If you do not override this method the means it gets the count is by calling the GetAllFeatureCore method and counting each feature. This is a very inefficient way to get the count in most data sources. It is highly recommended that you override this method and replace it with a highly optimized version. For example in a ShapeFile the record count is in the main header of the file. Similarly if you are using Oracle Spatial you can execute a simple query to get the count of all of the record without returning them. In these ways you can greatly improve the performance of this method.

• Type:Int32
• Description:This method returns the count of the number of records in this FeatureSource.

GetFeaturesInsideBoundingBoxCore(RectangleShape,IEnumerable<String>)

• N/A

• This method returns all of the InternalFeatures of this FeatureSource inside of the specified bounding box. If you are overriding this method you will not need to consider anything about transactions as this is handled by the concreate version of this method. The default implementation of GetFeaturesInsideBoundingBoxCore uses the GetAllRecordsCore method to determine which InternalFeatures are inside of the bounding box. We strongly recommend that you provide your own implementation for this method that will be more efficient. It is especially important for this method as many other default virtual methods use this for their calculations. We highly recommend when you override this method that you use any spatial indexes you have at your disposal to make this method as fast as possible.

• Type:Collection<Feature>
• Description:The return decimalDegreesValue is a collection of all of the InternalFeatures that are inside of the bounding box.

• boundingBox
  • Type:RectangleShape
  • Description:This parameter represents the bounding box you with to find InternalFeatures inside of.

• returningColumnNames
  • Type:IEnumerable<String>
  • Description:This parameter allows you to select the field names of the column data you wish to return with each Feature.

GetFeaturesOutsideBoundingBoxCore(RectangleShape,IEnumerable<String>)

• N/A

• This method returns all of the InternalFeatures of this FeatureSource outside of the specified bounding box. If you are in a transaction and that transaction is live then it will also take that into consideration. The default implementation of GetFeaturesOutsideBoundingBoxCore uses the GetAllRecordsCore method to determine which InternalFeatures are outside of the bounding box. We strongly recommend that you provide your own implementation for this method that will be more efficient

• Type:Collection<Feature>
• Description:This method returns all of the InternalFeatures of this FeatureSource outside of the specified bounding box.

• boundingBox
  • Type:RectangleShape
  • Description:This parameter represents the bounding box you with to find InternalFeatures outside of.

• returningColumnNames
  • Type:IEnumerable<String>
  • Description:This parameter allows you to select the field names of the column data you wish to return with each Feature.

CommitTransactionCore(TransactionBuffer)

• N/A

• This method will commit the existing transaction to its underlying source of data. It will pass back the results of how the commit went to include any error received. If you are implementing your own FeatureSource then this is one of the crucial methods you must create. It should be fairly straight forward that you will loop through the transaction buffer and add, edit or delete the InternalFeatures in your underlying data source. Remember to build and pass back the TransactionResult class so that users of your FeatureSource can respond to failures you may encounter committing the InternalFeatures. We will handle the end of the transaction and also the cleanup of the transaction buffer. Your task will be to commit the records and produce a TransactionResult return.The Transaction SystemThe transaction system of a FeatureSource sits on top of the inherited implementation of any specific source such as Oracle Spatial or Shape files. In this way it functions the same way for every FeatureSource. You start by calling the BeginTransaction. This allocates a collection of in memory change buffers that are used to store changes until you commit the transaction. So for example when you call the Add, Delete or Update method the changes to the feature are stored in memory only. If for any reason you choose to abandon the transaction you can call RollbackTransaction at any time and the in memory buffer will be deleted and the changes will be lost. When you are ready to commit the transaction you call the CommitTransaction and the collections of changes are then passed to the CommitTransactionCore method and the implementer of the specific FeatureSource is responsible for integrating your changes into the underlying FeatureSource. By default the IsLiveTransaction property is set to false which means that until you commit the changes the FeatureSource API will not reflect any changes that are in the temporary editing buffer.In the case where the IsLiveTransaction is set to true then things function slightly differently. The live transaction concept means that all of the modification you perform during a transaction are live from the standpoint of the querying methods on the object.To setup an example imagine that you have a FeatureSource that has 10 records in it. Next you begin a transaction and then call GetAllFeatures, the result would be 10 records. After that you call a delete on one of the records and call the GetAllFeatures again, this time you only get nine records. You receive nine records even though the transaction has not yet been committed. In the same sense you could have added a new record or modified an existing one and those changes are considered live though not committed.In the case where you modify records such as expanding the size of a polygon those changes as well are reflected. So for example you expand a polygon by doubling its size and then do a spatial query that would not normally return the smaller record but would return the larger records, in this case the larger record is returned. You can set this property to be false as well in which case all of the spatial related methods would ignore anything that is currently in the transaction buffer waiting to be committed. In this case only after committing the transaction would the FeatureSource reflect the changes.

• Type:TransactionResult
• Description:The return decimalDegreesValue of this method is a TransactionResult class which gives you the status of the transaction you just committed. It includes how many of the updates, adds, and deletes were successful and any error that were encountered during the committing of the transaction.

• transactions
  • Type:TransactionBuffer
  • Description:This parameter encapsulates all of the adds, edits and deleted that make up the transaction. You will use this data to write the changes to your underlying data source.

GetAllFeaturesCore(IEnumerable<String>)

• N/A

• This method returns all of the InternalFeatures in the FeatureSource. You will not need to consider anything about pending transactions as this will be handled in the non Core version of the method. The main purpose of this method is to be the anchor of all of our default virtual implementations within this class. We wanted as the framework developers to provide you the user with as much default virtual implementation as possible. To do this we needed a way to get access to all of the features. For example, we want to create a default implementation for finding all of the InternalFeatures in a bounding box. Because this is an abstract class we do not know the specifics of the underlying data or how its spatial indexes work. What we do know is that if we get all the records then we can brute force the answer. In this way if you inherited form this class and only implemented this one method we can provide default implementations for virtually every other API. While this is nice for you the developer if you decide to create your own FeatureSource it comes with a price. The price is that it is very inefficient. In the case we just discussed about finding all of the InternalFeatures in a bounding box we would not want to look at every record to fulfil this method. Instead we would want to override the GetFeaturesInsideBoundingBoxCore and implement specific code that would be fast. For example in Oracle Spatial there is a specific SQL statement to do this operation very quickly. The same holds true with other specific FeatureSource examples. Most default implementations in the FeatureSource call the GetFeaturesInsideBoundingBoxCore which by default calls the GetAllFeaturesCore. It is our advice that if you create your own FeatureSource that you ALWAYS override the GetFeatureInsideBoundingBox. It will ensure that nearly every other API will operate efficiently. Please see the specific API to determine what method it uses.

• Type:Collection<Feature>
• Description:The return decimalDegreesValue is a collection of all of the InternalFeatures in the FeatureSource.

• returningColumnNames
  • Type:IEnumerable<String>
  • Description:This parameter allows you to select the field names of the column data you wish to return with each Feature.

GetColumnsCore()

• N/A

• As this is the abstract core version of the Columns method it is intended to be overridden in inherited version of the class. When overriding you will be responsible for getting a list of all of the columns supported by the FeatureSource. In this way the FeatureSource will know what columns are available and will remove any extra columns when making calls to other core methods. For example if you have a FeatureSource that has three columns of information and the user calls a method and requests four columns of information, something they can do with custom fields, we will first compare what they are asking for to the results of the GetColumnsCore. In this way we can strip out custom columns before calling other Core methods which are only responsible for returning data in the FeatureSource. For more information on custom fields you can see the documentation on the OnCustomFieldsFetch.

• Type:Collection<FeatureSourceColumn>
• Description:This method returns the columns available for the FeatureSource.

GetBoundingBoxCore()

• N/A

• This protected virtual method is called from the concreate public method GetBoundingBox. It does not take into account any transaction activity as this is the responsibility of the concreate public method GetBoundingBox. In this way as a developer if you choose to override this method you do not have to consider transaction at all. The default implementation of GetBoundingBoxCore uses the GetAllRecordsCore method to calculate the bounding box of the FeatureSource. We strongly recommend that you provide your own implementation for this method that will be more efficient If you do not override this method the means it gets the BoundingBox is by calling the GetAllFeatureCore method and deriving it from each feature. This is a very inefficient way to get the BoundingBox in most data sources. It is highly recommended that you override this method and replace it with a highly optimized version. For example in a ShapeFile the BoundingBox is in the main header of the file. Similarly if you are using Oracle Spatial you can execute a simple query to get the BoundingBox of all of the record without returning them. In these ways you can greatly improve the performance of this method.

• Type:RectangleShape
• Description:This method returns the bounding box which encompasses all of the features in the FeatureSource.

GetFeaturesByIdsCore(IEnumerable<String>,IEnumerable<String>)

• N/A

• This method returns a collection of InternalFeatures by providing a group of Ids. The internal implementation calls the GetAllFeaturesCore. Because of this if you want an efficient version of this method then we high suggest you override the GetFeaturesByIdsCore method and provide a fast way to find a group of InternalFeatures by their Id.

• Type:Collection<Feature>
• Description:This method returns a collection of InternalFeatures by providing a group of Ids.

• ids
  • Type:IEnumerable<String>
  • Description:This parameter represents the group of Ids which uniquely identified the InternalFeatures in the FeatureSource.

• returningColumnNames
  • Type:IEnumerable<String>
  • Description:This parameter allows you to select the field names of the column data you wish to return with each Feature.

CanGetCountQuicklyCore()

• N/A

• N/A

• Type:Boolean
• Description:N/A

GetDistinctColumnValuesCore(String)

• N/A

• N/A

• Type:Collection<DistinctColumnValue>
• Description:N/A

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

GetAllFeaturesCore(IEnumerable<String>,Int32,Int32)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

• startIndex
  • Type:Int32
  • Description:N/A

• takeCount
  • Type:Int32
  • Description:N/A

RaiseCustomColumnFetchEvent(Collection<Feature>,Collection<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• sourceFeatures
  • Type:Collection<Feature>
  • Description:N/A

• fieldNamesOutsideOfSource
  • Type:Collection<String>
  • Description:N/A

GetFeatureIdsInsideBoundingBoxCore(RectangleShape)

• N/A

• N/A

• Type:Collection<String>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

ConvertToExternalProjectionIfNecessary(Collection<Feature>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• returnFeatures
  • Type:Collection<Feature>
  • Description:N/A

GetFeaturesForDrawingCore(RectangleShape,Double,Double,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• boundingBox
  • Type:RectangleShape
  • Description:N/A

• screenWidth
  • Type:Double
  • Description:N/A

• screenHeight
  • Type:Double
  • Description:N/A

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

SpatialQueryCore(BaseShape,QueryType,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• queryType
  • Type:QueryType
  • Description:N/A

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

GetFeaturesNearestToCore(BaseShape,GeographyUnit,Int32,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• maxItemsToFind
  • Type:Int32
  • Description:N/A

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

GetFeaturesWithinDistanceOfCore(BaseShape,GeographyUnit,DistanceUnit,Double,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• targetShape
  • Type:BaseShape
  • Description:N/A

• unitOfData
  • Type:GeographyUnit
  • Description:N/A

• distanceUnit
  • Type:DistanceUnit
  • Description:N/A

• distance
  • Type:Double
  • Description:N/A

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

GetBoundingBoxByIdCore(String)

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

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

ConvertToExternalProjection(IEnumerable<RectangleShape>)

• N/A

• N/A

• Type:Collection<RectangleShape>
• Description:N/A

• rectangles
  • Type:IEnumerable<RectangleShape>
  • Description:N/A

ConvertToInternalProjection(IEnumerable<RectangleShape>)

• N/A

• N/A

• Type:Collection<RectangleShape>
• Description:N/A

• rectangles
  • Type:IEnumerable<RectangleShape>
  • Description:N/A

ConvertToExternalProjection(RectangleShape)

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

• rectangle
  • Type:RectangleShape
  • Description:N/A

ConvertToInternalProjection(RectangleShape)

• N/A

• N/A

• Type:RectangleShape
• Description:N/A

• rectangle
  • Type:RectangleShape
  • Description:N/A

ConvertToInternalProjection(BaseShape)

• N/A

• N/A

• Type:BaseShape
• Description:N/A

• baseShape
  • Type:BaseShape
  • Description:N/A

ConvertToExternalProjection(IEnumerable<Feature>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• features
  • Type:IEnumerable<Feature>
  • Description:N/A

ConvertToInternalProjection(IEnumerable<Feature>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

• features
  • Type:IEnumerable<Feature>
  • Description:N/A

ConvertToExternalProjection(Feature)

• N/A

• N/A

• Type:Feature
• Description:N/A

• feature
  • Type:Feature
  • Description:N/A

ConvertToInternalProjection(Feature)

• N/A

• N/A

• Type:Feature
• Description:N/A

• feature
  • Type:Feature
  • Description:N/A

GetColumnNamesInsideFeatureSource(IEnumerable<String>)

• N/A

• N/A

• Type:Collection<String>
• Description:N/A

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

GetReturningColumnNames(ReturningColumnsType)

• N/A

• N/A

• Type:Collection<String>
• Description:N/A

• returningColumnNamesType
  • Type:ReturningColumnsType
  • Description:N/A

OnDrawingProgressChanged(DrawingProgressChangedEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

GetColumnNamesOutsideFeatureSourceCall(IEnumerable<String>)

• N/A

• N/A

• Type:Collection<String>
• Description:N/A

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

OnGettingColumns(GettingColumnsFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnGottenColumns(GottenColumnsFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnCustomColumnFetch(CustomColumnFetchEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnCommittingTransaction(CommittingTransactionEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnCommittedTransaction(CommittedTransactionEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnOpeningFeatureSource(OpeningFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnOpenedFeatureSource(OpenedFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnClosingFeatureSource(ClosingFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnClosedFeatureSource(ClosedFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnGettingFeaturesByIds(GettingFeaturesByIdsFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

OnGettingFeaturesForDrawing(GettingFeaturesForDrawingFeatureSourceEventArgs)

• N/A

• N/A

• Type:Void
• Description:N/A

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

GetFeaturesByColumnValueCore(String,String,IEnumerable<String>)

• N/A

• N/A

• Type:Collection<Feature>
• Description:N/A

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

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

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

CloneDeepCore()

• N/A

• N/A

• Type:FeatureSource
• Description:N/A

Finalize()

• N/A

• N/A

• Type:Void
• Description:N/A

MemberwiseClone()

• N/A

• N/A

• Type:Object
• Description:N/A

GeometryColumnName

• N/A

• N/A

• Type:String

CommandTimeout

• N/A

• This property gets and sets the time we will wait for a command to finish before we abort it. You can set this property to limit the amount of time you want to wait for a command to finish processing.

• Type:Int32

DatabaseConnectionMode

• N/A

• N/A

• Type:DatabaseConnectionMode

ConnectionString

• N/A

• None

• Type:String

TableName

• N/A

• None

• Type:String

FeatureIdColumn

• N/A

• None

• Type:String

IsEditable

• N/A

• This property is useful to check if a specific FeatureSource accepts editing. If you call the BeginTransaction and this property is false then an exception will be raised. For developers who are creating or extending a FeatureSource it is expected that you override this virtual method if the new FeatureSource you are creating allows edits. By default the decimalDegreesValue if false meaning that if you want to allow edits you must override this method and return true.

• Type:Boolean

WhereClause

• N/A

• N/A

• Type:String

Id

• N/A

• N/A

• Type:String

CanExecuteSqlQuery

• N/A

• N/A

• Type:Boolean

IsOpen

• N/A

• N/A

• Type:Boolean

CanModifyColumnStructure

• N/A

• N/A

• Type:Boolean

IsInTransaction

• N/A

• N/A

• Type:Boolean

IsTransactionLive

• N/A

• N/A

• Type:Boolean

Projection

• N/A

• N/A

• Type:Projection

GeoCache

• N/A

• N/A

• Type:FeatureCache

FeatureIdsToExclude

• N/A

• N/A

• Type:Collection<String>

TransactionBuffer

• N/A

• N/A

• Type:TransactionBuffer

MaxRecordsToDraw

• N/A

• N/A

• Type:Int32

GeometryValidationMode

• N/A

• N/A

• Type:GeometryValidationMode

CanExecuteSqlQueryCore

• N/A

• N/A

• Type:Boolean

IsOpenCore

• N/A

• N/A

• Type:Boolean

CanModifyColumnStructureCore

• N/A

• N/A

• Type:Boolean

FeatureSourceColumns

• N/A

• N/A

• Type:Collection<FeatureSourceColumn>

ExecutingSqlStatement

• N/A

• N/A

Event Arguments:ExecutingSqlStatementOracleFeatureSourceEventArgs

DrawingProgressChanged

• N/A

• N/A

Event Arguments:DrawingProgressChangedEventArgs

GettingColumns

• N/A

• N/A

Event Arguments:GettingColumnsFeatureSourceEventArgs

GottenColumns

• N/A

• N/A

Event Arguments:GottenColumnsFeatureSourceEventArgs

GettingFeaturesByIds

• N/A

• N/A

Event Arguments:GettingFeaturesByIdsFeatureSourceEventArgs

GettingFeaturesForDrawing

• N/A

• N/A

Event Arguments:GettingFeaturesForDrawingFeatureSourceEventArgs

CustomColumnFetch

• N/A

• N/A

Event Arguments:CustomColumnFetchEventArgs

CommittingTransaction

• N/A

• N/A

Event Arguments:CommittingTransactionEventArgs

CommittedTransaction

• N/A

• N/A

Event Arguments:CommittedTransactionEventArgs

OpeningFeatureSource

• N/A

• N/A

Event Arguments:OpeningFeatureSourceEventArgs

OpenedFeatureSource

• N/A

• N/A

Event Arguments:OpenedFeatureSourceEventArgs

ClosingFeatureSource

• N/A

• N/A

Event Arguments:ClosingFeatureSourceEventArgs

ClosedFeatureSource

• N/A

• N/A

Event Arguments:ClosedFeatureSourceEventArgs