Les objets de Recordset d'objet de donn�es d'ActiveX (AGITATION) repr�sente l'ensemble entier de disques d'une table basse ou des r�sultats d'une commande ex�cut�e. � tout moment, l'objet de Recordset se rapporte seulement � un disque simple dans l'ensemble comme disque courant.

Employer l'objet de Recordset aux commandes CHOISIES structur�es par question du langage d'interrogation (SQL) dans les chemises.

Par exemple :

Dim Conn as New ADODB.Connection
Dim Rs as New ADODB.Recordset
Conn.Provider = "ExOLEDB.DataSource"
Conn.Open RootFolderURL

Set Rs.ActiveConnection = Conn
"select ""DAV:displayname"" " _
& "from scope('shallow traversal of ""URL""')" _
& "Where ""DAV:ishidden"" = False"

'...
Conn.Close
Rs.Close
Set Conn = Nothing
Set Rs = Nothing

Des objets de Recordset d'objet de donn�es d'ActiveX (AGITATION) est employ�s pour manoeuvrer des donn�es d'un fournisseur. Quand nous employons l'AGITATION, nous manoeuvrons des donn�es employant presque enti�rement des objets de Recordset. Tous les objets de Recordset se composent des disques (rang�es) et des colonnes (champs). Selon l'appui fonctionnel par le fournisseur, quelques m�thodes ou propri�t�s de Recordset peuvent ne pas �tre disponibles.

Quand nous ouvrons d'abord un Recordset, l'indicateur de disque courant se dirigera au premier disque et les propri�t�s de BOF et d'EOF sont fausses. S'il y a aucun disque n'est pr�sent, le BOF et la propri�t� d'EOF sont vraie.

Il y a le type deux de mettre � jour cela volont� soutenue par (AGITATION) des objets de Recordset :

1 : Mise � jour imm�diate

2 : Mise � jour en lots

1 : Mise � jour imm�diate

Quand vous appelez la m�thode de mise � jour tous les changements sont �crits imm�diatement � la base de donn�es.

2 : Mise � jour en lots

Le fournisseur cachera les changements multiples et puis les enverra au disque dans la base de donn�es avec la m�thode d'UpdateBatch.

Quel est Curser ?

Curser est un �l�ment de base de donn�es que l'updatability des donn�es, la navigation d'ordre de gestions, et la visibilit� des changements ont fait aux therecords dans la base de donn�es par d'autres utilisateurs.

Il y a quatre types diff�rents de curseur d�finis dans l'AGITATION :

1 : Curseur dynamique

2 : Curseur de clavier

3 : Curseur statique

4 : Curseur Vers l'avant-seulement

1 : Curseur dynamique

Nous permet aux additions, � la vue, aux changements, et aux suppressions par les autres utilisateurs ; il permet �galement tous les types de mouvement par le Recordset qui ne se fonde pas sur des signets ; et permet des signets si le fournisseur les soutient.

2 : Curseur de clavier

Se comporte comme un curseur dynamique, sauf qu'il nous emp�che de voir les disques que les autres utilisateurs ajoutent, et emp�che l'acc�s aux disques que d'autres utilisateurs suppriment. Les changements de donn�es par d'autres utilisateurs seront toujours �vidents. Il soutient toujours des signets et permet donc tous les types de mouvement par le Recordset.

3 : Curseur statique

Fournit une copie statique d'un ensemble des disques pour nous pour employer pour trouver les donn�es ou se produit que des rapports ; il permet toujours des signets et permet donc tous les types de mouvement par le Recordset. Les additions, les suppressions ou les changements par d'autres utilisateurs ne seront pas �vidents. C'est le seul type de curseur permis quand vous ouvrez un objet de Recordset d'AGITATION de client-c�t�.

4 : Curseur Vers l'avant-seulement

Nous permet de faire d�filer seulement en avant par le Recordset dans la base de donn�es. Les changements, les additions ou les suppressions par d'autres utilisateurs ne seront pas �vidents. Ceci am�liore l'ex�cution dans les situations o� vous devez faire seulement un passage simple par un Recordset.

Propri�t�s d'objet de Recordset d'AGITATION.

Property	Description
AbsolutePage	Sets or returns a value that specifies the page number in the Recordset object
AbsolutePosition	Sets or returns a value that specifies the ordinal position of the current record in the Recordset object
ActiveCommand	Returns the Command object associated with the Recordset
ActiveConnection	Sets or returns a definition for a connection if the connection is closed, or the current Connection object if the connection is open
BOF	Returns true if the current record position is before the first record, otherwise false
Bookmark	Sets or returns a bookmark. The bookmark saves the position of the current record
CacheSize	Sets or returns the number of records that can be cached
CursorLocation	Sets or returns the location of the cursor service
CursorType	Sets or returns the cursor type of a Recordset object
DataMember	Sets or returns the name of the data member that will be retrieved from the object referenced by the DataSource property
DataSource	Specifies an object containing data to be represented as a Recordset object
EditMode	Returns the editing status of the current record
EOF	Returns true if the current record position is after the last record, otherwise false
Filter	Sets or returns a filter for the data in a Recordset object
Index	Sets or returns the name of the current index for a Recordset object
LockType	Sets or returns a value that specifies the type of locking when editing a record in a Recordset
MarshalOptions	Sets or returns a value that specifies which records are to be returned to the server
MaxRecords	Sets or returns the maximum number of records to return to a Recordset object from a query
PageCount	Returns the number of pages with data in a Recordset object
PageSize	Sets or returns the maximum number of records allowed on a single page of a Recordset object
RecordCount	Returns the number of records in a Recordset object
Sort	Sets or returns the field names in the Recordset to sort on
Source	Sets a string value or a Command object reference, or returns a String value that indicates the data source of the Recordset object
State	Returns a value that describes if the Recordset object is open, closed, connecting, executing or retrieving data
Status	Returns the status of the current record with regard to batch updates or other bulk operations
StayInSync	Sets or returns whether the reference to the child records will change when the parent record position changes

M�thodes d'objet de Recordset d'AGITATION.

Methods	Description
AddNew	Creates a new record
Cancel	Cancels an execution
CancelBatch	Cancels a batch update
CancelUpdate	Cancels changes made to a record of a Recordset object
Clone	Creates a duplicate of an existing Recordset
Close	Closes a Recordset
CompareBookmarks	Compares two bookmarks
Delete	Deletes a record or a group of records
Find	Searches for a record in a Recordset that satisfies a specified criteria
GetRows	Copies multiple records from a Recordset object into a two-dimensional array
GetString	Returns a Recordset as a string
Move	Moves the record pointer in a Recordset object
MoveFirst	Moves the record pointer to the first record
MoveLast	Moves the record pointer to the last record
MoveNext	Moves the record pointer to the next record
MovePrevious	Moves the record pointer to the previous record
NextRecordset	Clears the current Recordset object and returns the next Recordset object by looping through a series of commands
Open	Opens a database element that gives you access to records in a table, the results of a query, or to a saved Recordset
Requery	Updates the data in a Recordset by re-executing the query that made the original Recordset
Resync	Refreshes the data in the current Recordset from the original database
Save	Saves a Recordset object to a file or a Stream object
Seek	Searches the index of a Recordset to find a record that matches the specified values
Supports	Returns a boolean value that defines whether or not a Recordset object supports a specific type of functionality
Update	Saves all changes made to a single record in a Recordset object
UpdateBatch	Saves all changes in a Recordset to the database. Used when working in batch update mode

�v�nements :

Events	Description
EndOfRecordset	Triggered when you try to move to a record after the last record
FetchComplete	Triggered after all records in an asynchronous operation have been fetched
FetchProgress	Triggered periodically in an asynchronous operation, to state how many more records that have been fetched
FieldChangeComplete	Triggered after the value of a Field object change
MoveComplete	Triggered after the current position in the Recordset has changed
RecordChangeComplete	Triggered after a record has changed
RecordsetChangeComplete	Triggered after the Recordset has changed
WillChangeField	Triggered before the value of a Field object change
WillChangeRecord	Triggered before a record change
WillChangeRecordset	Triggered before a Recordset change
WillMove	Triggered before the current position in the Recordset changes