Shapefile attribute table

Functions
int	Shapefile.EditAddField (string Name, FieldType Type, int Precision, int Width)
	Adds a field to the attribute table of the shapefile. The table must be in editing mode.
bool	Shapefile.EditCellValue (int FieldIndex, int ShapeIndex, object newVal)
	Sets the new value for particular cell in attribute table. The table must be in editing mode.
bool	Shapefile.EditDeleteField (int FieldIndex, ICallback cBack)
	Deletes a field with the specified index from the attribute table. The table must be in editing mode.
bool	Shapefile.EditInsertField (Field NewField, ref int FieldIndex, ICallback cBack)
	Inserts a new field in the shapefile attribute table. The table must be in editing mode.
object	Shapefile.get_CellValue (int FieldIndex, int ShapeIndex)
	Gets the value of the specified field for the shape.
Field	Shapefile.get_Field (int FieldIndex)
	Gets a specific field stored in the attribute table.
Field	Shapefile.get_FieldByName (string Fieldname)
	Gets specific field stored in the attribute table.
bool	Shapefile.StartEditingTable (ICallback cBack)
	Opens editing mode for the attribute table.
bool	Shapefile.StopEditingTable (bool ApplyChanges, ICallback cBack)
	Closes the editing mode for the attribute table.
Properties
bool	Shapefile.EditingTable [get]
	Gets the value indicating whether editing operations are allowed for shapefile attribute table.
int	Shapefile.NumFields [get]
	Gets the number of fields in attribute table of the shapefile.
Table	Shapefile.Table [get]
	Gets the refererence to the attribute table associated with the shapefile.

---

Detailed Description

Here is a list of properties and methods to for interaction with attribute table associated with a shapefile. This module is a part of the documentation of Shapefile class.

Graph description

---

Function Documentation

int Shapefile.EditAddField	(	string	Name,
		FieldType	Type,
		int	Precision,
		int	Width
	)

Adds a field to the attribute table of the shapefile. The table must be in editing mode.

Parameters:

Name	The name of field.
Type	The type of field.
Precision	The precision of field.
Width	The width of field.

Returns:

The index of the new field or -1 on failure.

Examples:

AddCategoryRange.cs, CalculateArea.cs, CreateBuffer.cs, CreatePolygonShapefile.cs, RemoveShape.cs, and Segmentation.cs.

bool Shapefile.EditCellValue	(	int	FieldIndex,
		int	ShapeIndex,
		object	newVal
	)

Sets the new value for particular cell in attribute table. The table must be in editing mode.

Parameters:

FieldIndex	The index of field in attribute table.
ShapeIndex	The index of shape (row number in attribute table).
newVal	The variant value to be passed (integer, double and string values are accepted depending on field type).

Returns:

True on success and false otherwise.

Examples:

AddCategoryRange.cs, CalculateArea.cs, CreateBuffer.cs, CreatePolygonShapefile.cs, EditAttributes.cs, IntersectionLength.cs, MinimalDistance.cs, RemoveShape.cs, and Segmentation.cs.

bool Shapefile.EditDeleteField	(	int	FieldIndex,
		ICallback	cBack
	)

Deletes a field with the specified index from the attribute table. The table must be in editing mode.

Parameters:

FieldIndex	An index of field to be deleted.
cBack	An instance of class implementing ICallback interface. It's recommended to pass NULL and use Shapefile.GlobalCallback property instead.

Returns:

Returns true on success and false otherwise

Examples:

CalculateArea.cs.

bool Shapefile.EditInsertField	(	Field	NewField,
		ref int	FieldIndex,
		ICallback	cBack
	)

Inserts a new field in the shapefile attribute table. The table must be in editing mode.

Parameters:

NewField	A new instance of field object to insert.
FieldIndex	A position to insert the new field. An invalid index will be automatically substituted with 0 or Shapefile.NumFields.
cBack	An instance of class implementing ICallback interface. It's recommended to pass NULL and use Shapefile.GlobalCallback property instead.

Returns:

True on success and false otherwise.

Examples:

IntersectionLength.cs, and MinimalDistance.cs.

object Shapefile.get_CellValue	(	int	FieldIndex,
		int	ShapeIndex
	)

Gets the value of the specified field for the shape.

The value will be returned as VARIANT data type. When passing to then .NET it will be converted to either integer, double or string data type depending on the type of field.

Parameters:

FieldIndex	The index of field.
ShapeIndex	The index of shape.

Returns:

The value stored in the field.

Examples:

EditAttributes.cs, GenerateLabelsManually.cs, ShowAttributes.cs, ToolTip.cs, and ZoomToValues.cs.

Field Shapefile.get_Field

(

int

FieldIndex

)

Gets a specific field stored in the attribute table.

Parameters:

FieldIndex

The index of the field to be retrieved.

Returns:

Reference to the field object or NULL reference on failure.

Examples:

EditAttributes.cs, and ToolTip.cs.

Field Shapefile.get_FieldByName

(

string

Fieldname

)

Gets specific field stored in the attribute table.

Parameters:

Fieldname

The name of the field to be retrieved. The comaprison of the names is case insensitive.

Returns:

Reference to the field object or NULL reference on failure.

bool Shapefile.StartEditingTable

(

ICallback

cBack

)

Opens editing mode for the attribute table.

Parameters:

cBack

A callback object to report errors and progress information.

Returns:

True on success and false otherwise.

Examples:

AddCategoryRange.cs, and CalculateArea.cs.

bool Shapefile.StopEditingTable	(	bool	ApplyChanges,
		ICallback	cBack
	)

Closes the editing mode for the attribute table.

Parameters:

ApplyChanges	A boolean value which indicates whether changes made to the memory version of table should be saved to the drive.
cBack	A callback object to report errors and progress information.

Returns:

True on success and false otherwise.

---

Properties

bool Shapefile.EditingTable [get]

Gets the value indicating whether editing operations are allowed for shapefile attribute table.

Use Shapefile.StartEditingTable and Shapefile.StopEditingTable to control editing mode.

int Shapefile.NumFields [get]

Gets the number of fields in attribute table of the shapefile.

Examples:

EditAttributes.cs, MinimalDistance.cs, ShowAttributes.cs, and ToolTip.cs.

Table Shapefile.Table [get]

Gets the refererence to the attribute table associated with the shapefile.

Examples:

AddCategoryRange.cs, CalculateArea.cs, EditAttributes.cs, PointIcons.cs, SelectBox.cs, SelectByQuery.cs, ShowAttributes.cs, SplitByAttribute.cs, ToolTip.cs, and ZoomToValues.cs.