User Tools

Site Tools


thinkgeo.mapsuite.windowsphonecore.feature

ThinkGeo.MapSuite.WindowsPhoneCore.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.

<!– Structure –> 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

Members Summary

Public Constructors

Name Parameters DeclaringType Summary
Public MethodFeature BaseShape This method is the constructor for the Feature.
Public MethodFeature Byte[] This method is the constructor for the Feature.
Public MethodFeature Byte[], String This method is the constructor for the Feature.
Public MethodFeature String This method is the constructor for the Feature.
Public MethodFeature String, String This method is the constructor for the Feature.
Public MethodFeature BaseShape, IDictionary<String, String> This method is the constructor for the Feature.
Public MethodFeature String, String, IDictionary<String, String> This method is the constructor for the Feature.
Public MethodFeature String, String, IEnumerable<String>
Public MethodFeature Byte[], String, IEnumerable<String> This method is the constructor for the Feature.
Public MethodFeature Byte[], String, IDictionary<String, String> This method is the constructor for the Feature.
Public MethodFeature Vertex This method is the constructor for the Feature.
Public MethodFeature Vertex, String This method is the constructor for the Feature.
Public MethodFeature Vertex, String, IEnumerable<String> This method is the constructor for the Feature.
Public MethodFeature Double, Double This method is the constructor for the Feature.
Public MethodFeature Double, Double, String This method is the constructor for the Feature.
Public MethodFeature Double, Double, String, IEnumerable<String> This method is the constructor for the Feature.

Protected Constructors

Name Parameters DeclaringType Summary

Public Methods

Name Parameters DeclaringType Summary
Public MethodCloneDeep IEnumerable<String> This method clones the entire structure, creating a totally separate copy.
Public MethodCloneDeep ReturningColumnsType This method clones the entire structure, creating a totally separate copy.
Public MethodEquals Object Object(overriden) This method compares two InternalFeatures to see if they are equal.
Public MethodGetBoundingBox This method returns the bounding box of the Feature.
Public MethodGetHashCode Object(overriden) This method returns a semi-unique hash code for the Feature.
Public MethodGetShape This method returns the shape class that represents the Feature.
Public MethodGetType Object
Public MethodGetWellKnownBinary This method returns the well-known binary that represents the Feature.
Public MethodGetWellKnownText This method returns the well-known text that represents the Feature.
Public MethodGetWellKnownType This method returns the well known type that represents the Feature.
Public MethodIsValid This method returns the results of some simple validity tests on the Feature.
Public MethodToString Object(overriden)

Protected Methods

Name Parameters DeclaringType Summary
Protected MethodFinalize Object
Protected MethodMemberwiseClone Object

Public Properties

Name Return DeclaringType Summary
Public PropertyColumnValues Dictionary<String,String> This property gets a dictionary of values to represent the column data related to this Feature.
Public PropertyId String This property gets the Id for the Feature.
Public PropertyTag Object The tag of the Feature.

Protected Properties

Name Return DeclaringType Summary

Public Events

Name Event Arguments DeclaringType Summary

Public Constructors

Feature(BaseShape)

This method is the constructor for the Feature.

Overloads

This method allows you to pass in a BaseShape to construct your Feature.

Remarks

When you create the Feature, specify the ID of the BaseShape you want to use as a basis.

Parameters

Name Type Description
baseShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter represents the base shape you wish to use as the basis of the new Feature.

Go Back

Feature(Byte[])

This method is the constructor for the Feature.

Overloads

This overload allows you to create a feature using well-known binary.

Remarks

This overload allows you to create a feature using well-known binary. The Id for this Feature will be a random GUID.

Parameters

Name Type Description
wellKnownBinary Byte[]<!– System.Bytethinkgeo.mapsuite.windowsphonecore.feature –> This parameter is the well-known binary used to create the feature.

Go Back

Feature(Byte[], String)

This method is the constructor for the Feature.

Overloads

This overload allows you to create a feature using well-known binary and specify the Id.

Remarks

This overload allows you to create a feature using well-known binary and specify the Id.

Parameters

Name Type Description
wellKnownBinary Byte[]<!– System.Bytethinkgeo.mapsuite.windowsphonecore.feature –> This parameter is the well-known binary used to create the Feature.
id String<!– System.String –> This parameter is the Id used for the Feature.

Go Back

Feature(String)

This method is the constructor for the Feature.

Overloads

This overload allows you to create a feature using well-known text.

Remarks

This overload allows you to create a feature using well-known text. The Id for the Feature will be a random GUID.

Parameters

Name Type Description
wellKnownText String<!– System.String –> This parameter is the well-known text used to create the Feature.

Go Back

Feature(String, String)

This method is the constructor for the Feature.

Overloads

This overload allows you to create the Feature from well-known text and specify the Id.

Remarks

This overload allows you to create the Feature from well-known text and specify the Id.

Parameters

Name Type Description
wellKnownText String<!– System.String –> This parameter is the well-known text used to create the Feature.
id String<!– System.String –> This parameter is the Id used in the Feature.

Go Back

Feature(BaseShape, IDictionary<String, String>)

This method is the constructor for the Feature.

Overloads

This overload allows you to create the Feature from a baseShape and specify the column values.

Remarks

This overload allows you to create the Feature from a baseShape and specify the column values.

Parameters

Name Type Description
baseShape BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This parameter is the baseShape used to create the Feature.
columnValues IDictionary<String,String><!– System.Collections.Generic.IDictionary{System.String,System.String} –> This parameter is the columnValues used in the Feature.

Go Back

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

This method is the constructor for the Feature.

Overloads

This overload allows you to create the Feature from well-known text and feature ID, as well as specify the column values.

Remarks

This overload allows you to create the Feature from well-known text and feature ID, as well as specify the column values.

Parameters

Name Type Description
wellKnownText String<!– System.String –> This parameter is the well-known text used to create the Feature.
id String<!– System.String –> This parameter is the Id used in the Feature.
columnValues IDictionary<String,String><!– System.Collections.Generic.IDictionary{System.String,System.String} –> This parameter is the columnValues used in the Feature.

Go Back

Feature(String, String, IEnumerable<String>)

Parameters

Name Type Description
wellKnownText String<!– System.String –>
id String<!– System.String –>
columnValues IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –>

Go Back

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

This method is the constructor for the Feature.

Overloads

This overload allows you to create the Feature from well-known binary and feature ID, as well as specify the column values.

Remarks

This overload allows you to create the Feature from well-known binary and feature ID, as well as specify the column values.

Parameters

Name Type Description
wellKnownBinary Byte[]<!– System.Bytethinkgeo.mapsuite.windowsphonecore.feature –> This parameter is the well-known binary used to create the Feature.
id String<!– System.String –> This parameter is the Id used in the Feature.
columnValues IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is the columnValues used in the Feature.

Go Back

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

This method is the constructor for the Feature.

Overloads

This overload allows you to create the Feature from well-known binary and feature ID, as well as specify the column values.

Remarks

This overload allows you to create the Feature from well-known binary and feature ID, as well as specify the column values.

Parameters

Name Type Description
wellKnownBinary Byte[]<!– System.Bytethinkgeo.mapsuite.windowsphonecore.feature –> This parameter is the well-known binary used to create the Feature.
id String<!– System.String –> This parameter is the Id used in the Feature.
columnValues IDictionary<String,String><!– System.Collections.Generic.IDictionary{System.String,System.String} –> This parameter is the columnValues used in the Feature.

Go Back

Feature(Vertex)

This method is the constructor for the Feature.

Overloads

This overload creates a point Feature for the vertex you pass in.

Remarks

You can use this constructor to create a point Feature easily.

Parameters

Name Type Description
vertex Vertex<!– ThinkGeo.MapSuite.WindowsPhoneCore.Vertex –> This parameter is the x & y decimalDegreesValue pair used to make the point. The Id for the Feature will be a random GUID.

Go Back

Feature(Vertex, String)

This method is the constructor for the Feature.

Overloads

This overload creates a point Feature for the vertex you pass in.

Remarks

You can use this constructor to create a point Feature and specify the Id.

Parameters

Name Type Description
vertex Vertex<!– ThinkGeo.MapSuite.WindowsPhoneCore.Vertex –> 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 String<!– System.String –> This parameter is the Id used in the Feature.

Go Back

Feature(Vertex, String, IEnumerable<String>)

This method is the constructor for the Feature.

Overloads

This overload creates a point Feature for the vertex you pass in.

Remarks

You can use this constructor to create a point Feature and specify the Id as well as the column values.

Parameters

Name Type Description
vertex Vertex<!– ThinkGeo.MapSuite.WindowsPhoneCore.Vertex –> 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 String<!– System.String –> This parameter is the Id used in the Feature.
columnValues IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is the columnValues used in the Feature.

Go Back

Feature(Double, Double)

This method is the constructor for the Feature.

Overloads

This overload creates a point feature for the vertex you pass in.

Remarks

You can use this constructor to create a point Feature based on x and y coordinates.

Parameters

Name Type Description
x Double<!– System.Double –> This parameter is the x decimalDegreesValue pair used to make the point. The Id for the Feature will be a random GUID.
y Double<!– System.Double –> This parameter is the y decimalDegreesValue pair used to make the point. The Id for the Feature will be a random GUID.

Go Back

Feature(Double, Double, String)

This method is the constructor for the Feature.

Overloads

This overload creates a point feature for the vertex you pass in.

Remarks

You can use this constructor to create a point Feature based on x and y coordinates and specify the Id.

Parameters

Name Type Description
x Double<!– System.Double –> This parameter is the x decimalDegreesValue pair used to make the point.
y Double<!– System.Double –> This parameter is the y decimalDegreesValue pair used to make the point.
id String<!– System.String –> This parameter is the Id used in the Feature.

Go Back

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

This method is the constructor for the Feature.

Overloads

This overload creates a point feature for the vertex you pass in.

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

Name Type Description
x Double<!– System.Double –> This parameter is the x decimalDegreesValue pair used to make the point.
y Double<!– System.Double –> This parameter is the y decimalDegreesValue pair used to make the point.
id String<!– System.String –> This parameter is the Id used in the Feature.
columnValues IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter is the columnValues used in the Feature. Each string

Go Back

Protected Constructors

Public Methods

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

Return Type Description
Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This method returns a clone of the entire structure, creating a totally separate copy.

Parameters

Name Type Description
returningColumnNames IEnumerable<String><!– System.Collections.Generic.IEnumerable{System.String} –> This parameter represents the columnar data fields that you wish to include in the clone.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

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

Return Type Description
Feature<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> This method returns a clone of the entire structure, creating a totally separate copy.

Parameters

Name Type Description
returningColumnNamesType ReturningColumnsType<!– ThinkGeo.MapSuite.WindowsPhoneCore.ReturningColumnsType –> This parameter allows you to select a type from the ReturningColumnsType that you wish to return with.

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

Equals(Object)

This method compares two InternalFeatures to see if they are equal.

Overloads

This method compares two InternalFeatures to see if they are equal.

Return Value

Return Type Description
Boolean<!– System.Boolean –> This method compares two InternalFeatures to see if they are equal.

Parameters

Name Type Description
obj Object<!– System.Object –> The first Feature.

<!– System.Object(overriden) –> Go Back

GetBoundingBox()

This method returns the bounding box of the Feature.

Return Value

Return Type Description
RectangleShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.RectangleShape –> This method returns the bounding box of the Feature.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

GetHashCode()

This method returns a semi-unique hash code for the Feature.

Return Value

Return Type Description
Int32<!– System.Int32 –> This method returns a semi-unique hash code for the Feature.

Parameters

Name Type Description

<!– System.Object(overriden) –> Go Back

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

Return Type Description
BaseShape<!– ThinkGeo.MapSuite.WindowsPhoneCore.BaseShape –> This method returns the shape class that represents the Feature.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

GetType()

Return Value

Return Type Description
Type<!– System.Type –>

Parameters

Name Type Description

<!– System.Object –> Go Back

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

Return Type Description
Byte[]<!– System.Bytethinkgeo.mapsuite.windowsphonecore.feature –> This method returns the well-known binary that represents the Feature.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

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

Return Type Description
String<!– System.String –> This method returns the well-known text that represents the Feature.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

GetWellKnownType()

This method returns the well known type that represents the Feature.

Return Value

Return Type Description
WellKnownType<!– ThinkGeo.MapSuite.WindowsPhoneCore.WellKnownType –> This method returns the well known type that represents the Feature.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

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

Return Type Description
Boolean<!– System.Boolean –> This method returns the results of some simple validity tests on the Feature.

Parameters

Name Type Description

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

ToString()

Return Value

Return Type Description
String<!– System.String –>

Parameters

Name Type Description

<!– System.Object(overriden) –> Go Back

Protected Methods

Finalize()

Return Value

Return Type Description
Void<!– System.Void –>

Parameters

Name Type Description

<!– System.Object –> Go Back

MemberwiseClone()

Return Value

Return Type Description
Object<!– System.Object –>

Parameters

Name Type Description

<!– System.Object –> Go Back

Public Properties

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

Return Type
Dictionary<String,String><!– System.Collections.Generic.Dictionary{System.String,System.String} –>

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

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

Return Type
String<!– System.String –>

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

Tag

The tag of the Feature.

Return Value

Return Type
Object<!– System.Object –>

<!– ThinkGeo.MapSuite.WindowsPhoneCore.Feature –> Go Back

Protected Properties

Public Events

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