virtual MgPropertyCollection* MgLayerBase::UpdateFeatures

(

MgFeatureCommandCollection *

commands

)

[virtual]

Executes the MgDeleteFeatures, MgInsertFeatures, MgUpdateFeatures, MgLockFeatures or MgUnlockFeatures commands contained in the given MgFeatureCommandCollection object.

Remarks:

The XML returned by MgFeatureService::GetCapabilities says whether a provider supports SQL commands. See Provider Capabilities .

.NET Syntax

virtual MgPropertyCollection UpdateFeatures(MgFeatureCommandCollection commands);

Java Syntax

virtual MgPropertyCollection UpdateFeatures(MgFeatureCommandCollection commands);

PHP Syntax

virtual MgPropertyCollection UpdateFeatures(MgFeatureCommandCollection commands);

Parameters:

commands

(MgFeatureCommandCollection) A collection of feature commands to be executed.

Returns:

Returns an MgPropertyCollection object. Each property in the collection corresponds to a command in the MgFeatureCommandCollection argument. The property name is the index of the command in the feature command collection.

• If the command is of type MgDeleteFeatures, the property type is an MgPropertyType::Int32, and its value is the number of features deleted.
• If the command is of type MgInsertFeatures, the property type is an MgPropertyType::Feature, and its value is a MgFeatureReader object. The feature reader object contains the set of properties inserted into the datastore by the insert command.
• If the command is of type MgUpdateFeatures, the property type is MgPropertyType::Int32, and its value is the number of features updated.
• If the command is of type MgLockFeatures, the property type is MgPropertyType::Feature, and its value is the number of features locked.
• If the command is of type MgUnLockFeatures, the property type is MgPropertyType::Int32, and its value is the number of features unlocked.

Exceptions:

MgFeatureServiceException
MgInvalidArgumentException
MgInvalidOperationException
MgFdoException

Since:

1.2

Reimplemented in MgLayer.