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.
Le fournisseur SQLXMLOLEDB est un fournisseur OLE DB qui expose les fonctionnalités Microsoft SQLXML via ActiveX Data Objects (ADO). Toutefois, le fournisseur peut exécuter des commandes uniquement en mode « écrire dans un flux de sortie » d’ADO. Le fournisseur SQLXMLOLEDB n’est pas un fournisseur d’ensembles de lignes. Lorsque vous exécutez une commande, vous devez spécifier l’indicateur adExecuteStream, qui dirige ADO pour utiliser le flux de sortie que vous avez spécifié.
L’exemple suivant montre la syntaxe de la commande Execute dans laquelle l’indicateur adExecuteStream est spécifié :
Dim oTestCommand As New ADODB.Command
...
oTestCommand.Properties("Output Stream").Value = oTestStream
oTestCommand.Execute , , adExecuteStream
...
Propriétés spécifiques au fournisseur SQLXMLOLEDB
Le fournisseur SQLXMLOLEDB expose la propriété de connexion spécifique au fournisseur suivante.
| Connexion propriété |
Par défaut (le cas échéant) |
Descriptif |
|---|---|---|
| Fournisseur de données | Fournit le PROGID du fournisseur OLE DB via lequel SQLXMLOLEDB exécute les commandes. À compter de SQLXML 4.0 et SQL Server 2005, ce fournisseur est contenu dans SQL Server Native Client ; par conséquent, cette valeur de propriété est limitée à « SQLNCLI11 ». Pour plus d’informations, consultez Programmation SQL Server Native Client. |
Le fournisseur SQLXMLOLEDB expose les propriétés de commande spécifiques au fournisseur suivantes.
| Commande propriété |
Par défaut (le cas échéant) |
Descriptif |
|---|---|---|
| Chemin d’accès de base | "" | Spécifie le chemin du fichier de base. Le chemin d’accès au fichier de base permet de spécifier l’emplacement des fichiers de schéma XSL (XML Stylesheet Language) ou de mappage. Le chemin d’accès au fichier de base est également utilisé pour résoudre les chemins d’accès relatifs de fichiers de schéma XSL ou de mappage spécifiés dans les propriétés XSL ou Mappage de schéma. Pour obtenir un exemple dans lequel cette propriété est utilisée, consultez Exécution de requêtes XPath (fournisseur SQLXMLOLEDB). |
| ClientSideXML | Faux | Définissez cette propriété sur True si vous souhaitez que le processus de conversion de l’ensemble de lignes en XML se produise sur le client au lieu du serveur. Cela est utile lorsque vous souhaitez déplacer la charge de performances vers le niveau intermédiaire. Pour obtenir un exemple dans lequel cette propriété est utilisée, consultez Exécution de requêtes SQL (fournisseur SQLXMLOLEDB) ou exécution de modèles qui contiennent des requêtes SQL (fournisseur SQLXMLOLEDB). |
| Type de contenu | Retourne le type de contenu de sortie. Il s’agit d’une propriété READ ONLY. Cette propriété fournit des informations au navigateur sur le type de contenu (par exemple, TEXT/XML, TEXT/HTML, image/jpeg, etc.). La valeur de cette propriété devient le champ de type contenu envoyé au navigateur dans le cadre de l’en-tête HTTP, qui contient le type MIME (Extensions de messagerie Internet multi-usage) du document envoyé en tant que corps. |
|
| Schéma de mappage | ZÉRO | Si une application cliente exécute une requête XPath sur un schéma de mappage (XDR ou XSD), cette propriété est utilisée pour spécifier le nom du schéma de mappage. Le chemin spécifié peut être relatif (xyz/abc/MySchema.xml) ou absolu (C:\MyFolder\abc\MySchema.xml). Si un chemin relatif est spécifié, le chemin d’accès de base spécifié par la propriété Chemin d’accès de base est utilisé pour résoudre le chemin relatif. Si aucun chemin d’accès n’a été spécifié dans la propriété Chemin de base, le chemin relatif est relatif au répertoire actif. En spécifiant une valeur pour la propriété Schéma de mappage, vous pouvez spécifier un chemin d’accès de répertoire local ou une URL (http://...). Si vous spécifiez une URL, vous devez configurer WinHTTP pour accéder aux serveurs HTTP et HTTPS via un serveur proxy. Pour ce faire, exécutez l’utilitaire Proxycfg.exe. Pour plus d’informations, consultez « Utilisation de l’utilitaire de configuration du proxy WinHTTP » dans MSDN Library. Pour obtenir un exemple dans lequel cette propriété est utilisée, consultez Exécution de requêtes XPath (fournisseur SQLXMLOLEDB). |
| espaces de noms | Cette propriété permet l’exécution de requêtes XPath qui utilisent des espaces de noms. Pour obtenir un exemple dans lequel cette propriété est utilisée, consultez Exécution de requêtes XPath avec des espaces de noms (fournisseur SQLXMLOLEDB). | |
| indicateurs de flux ss | Cette propriété est utilisée pour spécifier des types particuliers de restrictions de sécurité. Par exemple, vous ne souhaiterez peut-être pas autoriser les références d’URL à des fichiers ou des chemins absolus de fichiers (tels que des sites externes). Vous ne souhaiterez peut-être pas autoriser les requêtes dans les modèles. La propriété peut être affectée à ces valeurs : 1 = STREAM_FLAGS_DISALLOW_URL 2 = STREAM_FLAGS_DISALLOW_ABSOLUTE_PATH 4 = STREAM_FLAGS_DISALLOW_QUERY 8 = STREAM_FLAGS_ DONTCACHEMAPPINGSCHEMA 16 = STREAM_FLAGS_DONTCACHETEMPLATE 32 = STREAM_FLAGS_DONTCACHEXSL Des informations supplémentaires sur ces valeurs sont fournies dans le tableau suivant. |
|
| racine xml | Cette propriété est utilisée pour définir une balise racine pour le code XML résultant. Par exemple, si vous exécutez des requêtes SQL sur la base de données et que le document XML résultant n’a pas d’élément racine unique, la valeur de la propriété est utilisée pour ajouter un élément racine unique au document. Pour obtenir un exemple dans lequel cette propriété est utilisée, consultez Exécution de requêtes SQL (fournisseur SQLXMLOLEDB). |
|
| xsl | Cette propriété est utilisée pour spécifier le nom de fichier XSL lorsque vous souhaitez appliquer la transformation XSL au document XML retourné par la requête. Le chemin spécifié peut être relatif (xyz/abc/MyXSL.xsl) ou absolu (C :\MyFolder\abc\MyXSL.xsl). Si un chemin relatif est spécifié, le chemin d’accès de base spécifié par la propriété Chemin d’accès de base est utilisé pour résoudre le chemin relatif. Si aucun chemin d’accès n’a été spécifié dans la propriété Chemin de base, le chemin relatif est relatif au répertoire actif. Pour obtenir un exemple dans lequel cette propriété est utilisée, consultez Application d’une transformation XSL (fournisseur SQLXMLOLEDB). |
Le tableau suivant contient des descriptions des valeurs de propriété ss Stream Flags.
| Valeur de la propriété | Descriptif |
|---|---|
| STREAM_FLAGS_DISALLOW_URL | Les URL ne sont pas acceptées pour les schémas de mappage ou XSL. |
| STREAM_FLAGS_DISALLOW_ABSOLTE_PATH | Un chemin spécifié pour un schéma de mappage ou pour XSL doit être relatif au chemin de base du modèle lui-même. |
| STREAM_FLAGS_DISALLOW_QUERY | Les requêtes ne sont pas autorisées dans un modèle. |
| STREAM_FLAGS_DONTCACHEMAPPINGSCHEMA | Le schéma de mappage n’est pas mis en cache. Cette valeur de propriété est utile pendant la phase de développement de base de données, lorsque les schémas de base de données sont soumis à une modification. |
| STREAM_FLAGS_DONTCACHETEMPLATE | Les modèles ne sont pas mis en cache. |
| STREAM_FLAGS_DONTCACHEXSL | XSL n’est pas mis en cache. |