InsertCmdDataSource Property

Visual Studio .NET 2003

Specifies the data source to use for the InsertCmd property. Read/write at design time and run time.

Note   The CursorAdapter InsertCmdDataSource property determines how the InsertCmdDataSource property is used.
CursorAdapter.InsertCmdDataSource [= cDataSource]

Property Values

cDataSource
Character data type. The cDataSource parameter specifies the data source used by the InsertCmd property.

Remarks

The following table describes behaviors that apply to InsertCmdDataSource depending on the value of InsertCmdDataSourceType.

InsertCmdDataSourceType InsertCmdDataSource behavior
Empty ("") InsertCmdDataSource is disregarded. Visual FoxPro uses the data source in the CursorAdapter DataSource property.

However, if the cursor associated with the CursorAdapter object is based on an ActiveX Data Object (ADO) RecordSet, Visual FoxPro uses the functionality of the ADO RecordSet to insert the record. To use this functionality, make sure the CursorAdapter DataSourceType property is set to "ADO".

"ADO" InsertCmdDataSource must be set to a valid ADO Command object. The ActiveConnection property of the ADO Command object must be set to a valid and open ADO Connection object.

Visual FoxPro sets the CommandText property of the ADO Command object to the value of the CursorAdapter InsertCmd property. Visual FoxPro parses the command for parameters, creates parameter values if found, and sets them in the Command object.

The insert operation occurs as:

CursorAdapter.InsertCmdDataSource.Execute()

For more information about using an ADO RecordSet, automatic updating, and generating SQL commands automatically, see Data Access Management Using CursorAdapters.

"XML" Visual FoxPro disregards the CursorAdapter DataSource property.

See Also

Properties | CursorAdapter Object Properties, Methods, and Events

Applies To: CursorAdapter Class

Show: