Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Un ensemble de lignes est un ensemble de lignes qui contiennent des colonnes de données. Les ensembles de lignes sont des objets centraux qui permettent à tous les fournisseurs de données OLE DB d’exposer les données du jeu de résultats sous forme tabulaire.
Une fois qu’un consommateur a créé une session à l’aide de la méthode IDBCreateSession ::CreateSession , le consommateur peut utiliser l’interface IOpenRowset ou IDBCreateCommand sur la session pour créer un ensemble de lignes. Le fournisseur OLE DB SQL Server Native Client prend en charge ces deux interfaces. Ces deux méthodes sont décrites ici.
Créez un ensemble de lignes en appelant la méthode IOpenRowset ::OpenRowset .
Cela équivaut à créer un ensemble de lignes sur une seule table. Cette méthode s’ouvre et retourne un ensemble de lignes qui inclut toutes les lignes d’une table de base unique. L’un des arguments d’OpenRowset est un ID de table qui identifie la table à partir de laquelle créer l’ensemble de lignes.
Créez un objet de commande en appelant la méthode IDBCreateCommand ::CreateCommand .
L’objet de commande exécute des commandes que le fournisseur prend en charge. Avec le fournisseur OLE DB SQL Server Native Client, le consommateur peut spécifier n’importe quelle instruction Transact-SQL, telle qu’une instruction SELECT ou un appel à une procédure stockée. Les étapes de création d’un ensemble de lignes à l’aide d’un objet de commande sont les suivantes :
Le consommateur appelle la méthode IDBCreateCommand ::CreateCommand sur la session pour obtenir un objet de commande demandant l’interface ICommandText sur l’objet de commande. Cette interface ICommandText définit et récupère le texte de commande réel. Le consommateur remplit la commande de texte en appelant la méthode ICommandText ::SetCommandText .
L’utilisateur appelle la méthode ICommand ::Execute sur la commande. Objet d’ensemble de lignes généré lorsque la commande s’exécute contient le jeu de résultats de la commande.
Le consommateur peut utiliser l’interface ICommandProperties pour obtenir ou définir les propriétés de l’ensemble de lignes retourné par la commande exécutée par les interfaces ICommand ::Execute . Les propriétés les plus couramment demandées sont les interfaces que l’ensemble de lignes doit prendre en charge. En plus des interfaces, le consommateur peut demander des propriétés qui modifient le comportement de l’ensemble de lignes ou de l’interface.
Les consommateurs libèrent des ensembles de lignes avec la méthode IRowset ::Release . La libération d’un ensemble de lignes libère tous les handles de ligne détenus par le consommateur sur cet ensemble de lignes. La libération d’un ensemble de lignes ne libère pas les accesseurs. Si vous disposez d’une interface IAccessor , elle doit toujours être publiée.