Data.Win.ADODB.TCustomADODataSet.Recordset

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Recordset: _Recordset read FRecordsetObject write SetRecordset;

C++

__property Winapi::Adoint::_di__Recordset Recordset = {read=FRecordsetObject, write=SetRecordset};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Data.Win.ADODB.pas
Data.Win.ADODB.hpp
Data.Win.ADODB TCustomADODataSet

Description

Donne accès à l'objet ensemble d'enregistrements ADO.

Recordset est l'interface via laquelle s'effectue l'accès aux enregistrements d'un ensemble de données ADO. Quand vous ouvrez un ensemble de données ADO, l'interface qui fournit l'accès aux enregistrements est affectée automatiquement à la propriété Recordset. Cette valeur ne doit être utilisée qu'après le déclenchement d'un événement OnRecordsetCreate.

Utilisez Recordset pour accéder directement à l'objet ensemble d'enregistrements ADO que représente le composant ensemble de données. Cet accès direct permet à une application d'utiliser les propriétés et méthodes de l'objet ensemble d'enregistrements sous-jacent. Accéder directement à l'objet ensemble d'enregistrements sous-jacent est particulièrement pratique si vous voulez utiliser des propriétés et méthodes de l'objet ensemble d'enregistrements qui ne sont pas représentées dans les composants ensemble de données ADO.

Généralement, une application a rarement besoin d'accéder directement à l'objet ensemble d'enregistrements sous-jacent. Cela peut se produire si vous souhaitez rediriger l'ensemble d'enregistrements résultant de l'exécution d'un composant TADOCommand. Dans ce cas, affectez directement à la propriété Recordset l'ensemble d'enregistrements renvoyé par la méthode Execute (TADOCommand).


ADODataSet1.Recordset := ADOCommand1.Execute;
ADODataSet1->Recordset = ADOCommand1->Execute();

Remarque :  L'utilisation de Recordset pour accéder directement à l'objet ensemble d'enregistrements ADO sous-jacent suppose une bonne connaissance des objets ADO en général et de l'objet ensemble d'enregistrements ADO en particulier. L'utilisation de l'ensemble d'enregistrements n'est pas conseillée à moins d'être familiarisé avec sa manipulation. Consultez l'aide Data Store SDK de Microsoft pour avoir des informations sur l'utilisation des objets ensemble d'enregistrements.

Voir aussi