DK for .NET | TatukGIS.NDK.TGIS_LayerVector.Build | Overloads | Constructors | Fields | Methods | Properties | Events
Create and initialize layer storage with the specified shape type and extent using the layer default dimensionality.
// C# public virtual void Build( string _path, TGIS_Extent _extent, TGIS_ShapeType _type );
' VisualBasic Public Overridable Sub Build( ByVal _path As String, ByVal _extent As TGIS_Extent, ByVal _type As TGIS_ShapeType )
// Oxygene public procedure Build( _path : String; _extent : TGIS_Extent; _type : TGIS_ShapeType ); virtual;
| Name | Type | Description |
|---|---|---|
| _path | string String | Storage location as a file path for file-based layers or a connection string for SQL (Structured Query Language)-based layers. |
| _extent | TGIS_Extent | Initial bounding extent for the layer. It must be non-zero sized. |
| _type | TGIS_ShapeType | Shape geometry type supported by the layer. |
PURPOSE: Prepare persistent storage for a new vector layer when the shape geometry type must be defined at creation time.
BEHAVIOR: Creates the underlying storage required by the concrete layer type, such as files for file-based formats or database objects for SQL-backed layers. The layer is initialized to accept only the specified shape type and uses the default coordinate dimensionality for stored shapes.
CONSTRAINTS: Supported storage objects depend on the descendant layer implementation. The path or connection target must be writable, the extent must be valid, and read-only layer types can reject this operation.
Here is a simple procedure to add a new layer to the viewer.