Accès aux données XML

Mise à jour : novembre 2007

Il existe deux méthodes distinctes pour la récupération de données XML à partir d'une source de données : la première utilise CStreamRowset et la seconde CXMLAccessor :

Fonctionnalité	CStreamRowset	CXMLAccessor
Quantité de données transférées	Récupère les données à partir de toutes les colonnes et les lignes simultanément.	Récupère des données de toutes les colonnes mais une seule ligne à la fois. Vous devez toujours parcourir les lignes en utilisant des méthodes telles que MoveNext.
Formatage de la chaîne	SQL Server formate la chaîne XML et l'envoie au consommateur.	Récupère les données du jeu de lignes dans son format natif (demande que le fournisseur les envoie en tant que chaînes Unicode), puis construit la chaîne contenant les données au format XML.
Contrôle du formatage	Vous avez un certain niveau de contrôle sur la façon dont la chaîne XML est mise en forme en définissant quelques propriétés spécifiques de SQL Server 2000.	Vous n'avez aucun contrôle sur le format de la chaîne XML générée.

Si CStreamRowset constitue globalement une méthode plus efficace pour la récupération de données au format XML, elle n'est prise en charge que par SQL Server 2000.

Récupération de données XML à l'aide de CStreamRowset

Vous devez spécifier CStreamRowset en tant que type de jeu de lignes dans votre déclaration de CCommand ou de CTable. Vous pouvez l'utiliser avec votre propre accesseur ou sans accesseur, par exemple :

CCommand< CAccessor<CMyAccessor>, CStreamRowset > myCmd;

- ou -

CCommand< CNoAccessor, CStreamRowset > myCmd;

Normalement lorsque vous appelez CCommand::Open (par exemple, en spécifiant CRowset comme classe TRowset), elle obtient un pointeur IRowset . ICommand::Execute retourne un pointeur IRowset qui est stocké dans le membre m_spRowset de l'objet CRowset. Des méthodes telles que MoveFirst, MoveNext et GetData utilisent ce pointeur pour récupérer les données.

En revanche, lorsque vous appelez CCommand::Open (mais spécifiez CStreamRowset en tant que classe TRowset), ICommand::Execute retourne un pointeur ISequentialStream, qui est stocké dans la donnée membre m_spStream de CStreamRowset. Vous utilisez ensuite la méthode Read pour récupérer les données (chaîne Unicode) au format XML. Par exemple :

myCmd.m_spStream->Read()

SQL Server 2000 effectue la mise en forme XML et retourne toutes les colonnes et toutes les lignes du jeu de lignes en tant que chaînes XML uniques.

Pour obtenir un exemple d'utilisation de la méthode Read, consultez « Ajout de la prise en charge XML au consommateur » dans Implémentation d'un consommateur simple.

Remarque :
La prise en charge de XML à l'aide de CStreamRowset fonctionne seulement avec SQL Server 2000, et requiert le fournisseur OLE DB pour SQL Server 2000 (installé avec MDAC).

Récupération de données XML à l'aide de CXMLAccessor

CXMLAccessor vous permet d'accéder aux données à partir d'une source de données en tant que données de type chaîne lorsque vous n'avez aucune information sur le schéma du magasin de données. CXMLAccessor fonctionne à l'instar de CDynamicStringAccessorW, sauf que la première convertit toutes les données ayant fait l'objet d'un accès à partir du magasin de données en tant que données dans un format (balisage) XML. Les noms des balises XML correspondent aux noms des colonnes du magasin de données aussi étroitement que possible.

Utilisez CXMLAccessor comme n'importe quelle autre classe d'accesseur, en la passant en tant que paramètre de modèle à CCommand ou CTable :

CTable<CXMLAccessor, CRowset> rs;

Utilisez GetXMLRowData pour récupérer les données de la table une ligne à la fois, et parcourez les lignes en faisant appel à des méthodes telles que MoveNext, par exemple :

// Open data source, session, and rowset
hr = rs.MoveFirst();
while( SUCCEEDED(hr) && hr != DB_S_ENDOFROWSET )
{
    CStringW strRowData;
    myCmd.GetXMLRowData(strRowData);

    printf_s( "%S\n", strRowData );

    hr = rs.MoveNext();
}

Vous pouvez utiliser GetXMLColumnData pour récupérer des informations sur les colonnes (type de données) en tant que données de type chaîne au format XML.

Voir aussi

Concepts

Utilisation des accesseurs