User Tools

Site Tools


thinkgeo.mapsuite.silverlightcore.feature

ThinkGeo.MapSuite.SilverlightCore.Feature

Note: The page was created before Map Suite 10. Map Suite 10.0 organized many classes into new namespaces and assemblies as well as had a few minor breaks in compatibility. The majority of previously built code should work without modification assuming the new namespaces are added. For guidance on upgrading your existing code, please check out MapSuite 10 Upgrade Guide.

The class Feature is the basic unit of which a FeatureSource is composed. A FeatureSource can be taken from a collection of Features stored in a ShapeFile, SQL Server 2008, Oracle, etc.A Feature is the basic data unit structure which is comprised of IDs that mark the identification of the Feature, a shape and a collection of data.

Inheritance Hierarchy

  • System.Object
    • System.ValueType
      • ThinkGeo.MapSuite.SilverlightCore.Feature

Members Summary

Public Constructors

Feature(BaseShape)

  • This method is the constructor for the Feature.
Remarks
  • When you create the Feature, specify the ID of the BaseShape you want to use as a basis.
Parameters
  • baseShape
    • Type:BaseShape
    • Description:This parameter represents the base shape you wish to use as the basis of the new Feature.

Feature(Byte[])

  • This method is the constructor for the Feature.
Remarks
  • This overload allows you to create a feature using well-known binary. The Id for this Feature will be a random GUID.
Parameters
  • wellKnownBinary
    • Type:Byte[]
    • Description:This parameter is the well-known binary used to create the feature.

Feature(Byte[],String)

  • This method is the constructor for the Feature.
Remarks
  • This overload allows you to create a feature using well-known binary and specify the Id.
Parameters
  • wellKnownBinary
    • Type:Byte[]
    • Description:This parameter is the well-known binary used to create the Feature.
  • id
    • Type:String
    • Description:This parameter is the Id used for the Feature.

Feature(String)

  • This method is the constructor for the Feature.
Remarks
  • This overload allows you to create a feature using well-known text. The Id for the Feature will be a random GUID.
Parameters
  • wellKnownText
    • Type:String
    • Description:This parameter is the well-known text used to create the Feature.

Feature(String,String)

  • This method is the constructor for the Feature.
Remarks
  • This overload allows you to create the Feature from well-known text and specify the Id.
Parameters
  • wellKnownText
    • Type:String
    • Description:This parameter is the well-known text used to create the Feature.
  • id
    • Type:String
    • Description:This parameter is the Id used in the Feature.

Feature(BaseShape,IDictionary<String,String>)

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

Feature(String,String,IDictionary<String,String>)

  • N/A
Remarks
  • N/A
Parameters
  • wellKnownText
    • Type:String
    • Description:N/A
  • id
    • Type:String
    • Description:N/A
  • columnValues
    • Type:IDictionary<String,String>
    • Description:N/A

Feature(String,String,IEnumerable<String>)

  • N/A
Remarks
  • N/A
Parameters
  • wellKnownText
    • Type:String
    • Description:N/A
  • id
    • Type:String
    • Description:N/A
  • columnValues
    • Type:IEnumerable<String>
    • Description:N/A

Feature(Byte[],String,IEnumerable<String>)

  • This method is the constructor for the Feature.
Remarks
  • This overload allows you to create the Feature from well-known binary and feature ID, as well as specify the column values.
Parameters
  • wellKnownBinary
    • Type:Byte[]
    • Description:This parameter is the well-known binary used to create the Feature.
  • id
    • Type:String
    • Description:This parameter is the Id used in the Feature.
  • columnValues
    • Type:IEnumerable<String>
    • Description:This parameter is the columnValues used in the Feature.

Feature(Byte[],String,IDictionary<String,String>)

  • N/A
Remarks
  • N/A
Parameters
  • wellKnownBinary
    • Type:Byte[]
    • Description:N/A
  • id
    • Type:String
    • Description:N/A
  • columnValues
    • Type:IDictionary<String,String>
    • Description:N/A

Feature(Vertex)

  • This method is the constructor for the Feature.
Remarks
  • You can use this constructor to create a point Feature easily.
Parameters
  • vertex
    • Type:Vertex
    • Description:This parameter is the x & y decimalDegreesValue pair used to make the point. The Id for the Feature will be a random GUID.

Feature(Vertex,String)

  • This method is the constructor for the Feature.
Remarks
  • You can use this constructor to create a point Feature and specify the Id.
Parameters
  • vertex
    • Type:Vertex
    • Description:This parameter is the x & y decimalDegreesValue pair used to make the point. The Id for the Feature will be the value you pass in through the id parameter.
  • id
    • Type:String
    • Description:This parameter is the Id used in the Feature.

Feature(Vertex,String,IEnumerable<String>)

  • This method is the constructor for the Feature.
Remarks
  • You can use this constructor to create a point Feature and specify the Id as well as the column values.
Parameters
  • vertex
    • Type:Vertex
    • Description:This parameter is the x & y decimalDegreesValue pair used to make the point. The Id for the Feature will be the value you pass in through the id parameter.
  • id
    • Type:String
    • Description:This parameter is the Id used in the Feature.
  • columnValues
    • Type:IEnumerable<String>
    • Description:This parameter is the columnValues used in the Feature.

Feature(Double,Double)

  • This method is the constructor for the Feature.
Remarks
  • You can use this constructor to create a point Feature based on x and y coordinates.
Parameters
  • x
    • Type:Double
    • Description:This parameter is the x decimalDegreesValue pair used to make the point. The Id for the Feature will be a random GUID.
  • y
    • Type:Double
    • Description:This parameter is the y decimalDegreesValue pair used to make the point. The Id for the Feature will be a random GUID.

Feature(Double,Double,String)

  • This method is the constructor for the Feature.
Remarks
  • You can use this constructor to create a point Feature based on x and y coordinates and specify the Id.
Parameters
  • x
    • Type:Double
    • Description:This parameter is the x decimalDegreesValue pair used to make the point.
  • y
    • Type:Double
    • Description:This parameter is the y decimalDegreesValue pair used to make the point.
  • id
    • Type:String
    • Description:This parameter is the Id used in the Feature.

Feature(Double,Double,String,IEnumerable<String>)

  • This method is the constructor for the Feature.
Remarks
  • You can use this constructor to create a point Feature based on x and y coordinates and specify both the Id and the column values.
Parameters
  • x
    • Type:Double
    • Description:This parameter is the x decimalDegreesValue pair used to make the point.
  • y
    • Type:Double
    • Description:This parameter is the y decimalDegreesValue pair used to make the point.
  • id
    • Type:String
    • Description:This parameter is the Id used in the Feature.
  • columnValues
    • Type:IEnumerable<String>
    • Description:This parameter is the columnValues used in the Feature. Each string

Protected Constructors

Public Methods

GetWellKnownBinary()

  • This method returns the well-known binary that represents the Feature.
Remarks
  • This will return a copy of the well-known binary that represents the Feature.
Return Value
  • Type:Byte[]
  • Description:This method returns the well-known binary that represents the Feature.
Parameters

GetWellKnownType()

  • This method returns the well known type that represents the Feature.
Remarks
  • None
Return Value
  • Description:This method returns the well known type that represents the Feature.
Parameters

GetShape()

  • This method returns the shape class that represents the Feature.
Remarks
  • This method allows you to get a shape class from a Feature. Because the Feature stores the geometry for itself in well-known binary, it may take some time to generate a shape class if the geometry is complex.
Return Value
  • Type:BaseShape
  • Description:This method returns the shape class that represents the Feature.
Parameters

GetWellKnownText()

  • This method returns the well-known text that represents the Feature.
Remarks
  • This method allows you to get the well-known text from a Feature. Because the Feature stores the geometry for itself in well-known binary, it may take some time to generate the text if the geometry is complex.
Return Value
  • Type:String
  • Description:This method returns the well-known text that represents the Feature.
Parameters

GetBoundingBox()

  • This method returns the bounding box of the Feature.
Remarks
  • None
Return Value
  • Description:This method returns the bounding box of the Feature.
Parameters

CloneDeep(IEnumerable<String>)

  • This method clones the entire structure, creating a totally separate copy.
Remarks
  • This method will return a complete copy of the Feature. As this is a deep clone, there are no shared references between the source and the copy.
Return Value
  • Type:Feature
  • Description:This method returns a clone of the entire structure, creating a totally separate copy.
Parameters
  • returningColumnNames
    • Type:IEnumerable<String>
    • Description:This parameter represents the columnar data fields that you wish to include in the clone.

CloneDeep(ReturningColumnsType)

  • This method clones the entire structure, creating a totally separate copy.
Remarks
  • This method will return a complete copy of the Feature. As this is a deep clone, there are no shared references between the source and the copy.
Return Value
  • Type:Feature
  • Description:This method returns a clone of the entire structure, creating a totally separate copy.
Parameters
  • returningColumnNamesType
    • Description:This parameter allows you to select a type from the ReturningColumnsType that you wish to return with.

IsValid()

  • This method returns the results of some simple validity tests on the Feature.
Remarks
  • This method is used primarily to ensure that a Feature is valid. The reason is, since this is a structure, we cannot control the main constructor that allows you to create a Feature in an invalid state – that state being one with no well-known binary at its core. If you use the constructure set provided, then the state should always be valid. This is a property you may want to check before you work with a Feature.
Return Value
  • Type:Boolean
  • Description:This method returns the results of some simple validity tests on the Feature.
Parameters

Equals(Object)

  • This method compares two InternalFeatures to see if they are equal.
Remarks
  • None
Return Value
  • Type:Boolean
  • Description:This method compares two InternalFeatures to see if they are equal.
Parameters
  • obj
    • Type:Object
    • Description:The first Feature.

GetHashCode()

  • This method returns a semi-unique hash code for the Feature.
Remarks
  • None
Return Value
  • Type:Int32
  • Description:This method returns a semi-unique hash code for the Feature.
Parameters

ToString()

  • N/A
Remarks
  • N/A
Return Value
  • Type:String
  • Description:N/A
Parameters

GetType()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Type
  • Description:N/A
Parameters

Protected Methods

Finalize()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Void
  • Description:N/A
Parameters

MemberwiseClone()

  • N/A
Remarks
  • N/A
Return Value
  • Type:Object
  • Description:N/A
Parameters

Public Properties

Id

This property gets the Id for the Feature.

Remarks

The Id is a string that represents the unique identifier for this Feature. If the feature is returned from a FeatureSource, the Id will be the unique field descriptor used by the FeatureSource. For Shape Files this may be an integer, but for spatial databases the Id may be a GUID.

Return Value
  • Type:String

Tag

The tag of the Feature.

Remarks

N/A

Return Value
  • Type:Object

ColumnValues

This property gets a dictionary of values to represent the column data related to this Feature.

Remarks

This property holds the column data related to this Feature. You can find the values in the dictionary using the column name as the key. Most methods that query and return InternalFeatures allow you to specify which columns of data you want returned with the results. You can also freely add and modify the data, as it is simply an in-memory dictionary. Any values added, deleted or updated will have no effect unless the Feature is part of a transaction.

Return Value
  • Type:Dictionary<String,String>

Protected Properties

Public Events

thinkgeo.mapsuite.silverlightcore.feature.txt · Last modified: 2017/03/16 21:59 (external edit)