Objet SqlXmlCommand (classes managées SQLXML)

Il s’agit du constructeur de l’objet SqlXmlCommand :

public SqlXmlCommand(string cnString)  

Où cnString se trouve la chaîne de connexion ADO ou OLEDB qui identifie le serveur, la base de données et les informations de connexion, Provider=SQLOLEDB; Server=(local); database=AdventureWorks; Integrated Security=SSPI"par exemple.

Dans la chaîne de connexion, il Provider doit s’agir de SQLOLEDB et il Data Provider ne doit pas être inclus dans la chaîne de fournisseur.

Pour obtenir un exemple de travail, consultez Exécution de requêtes SQL (classes managées SQLXML).

Méthodes

L’objet TheSqlXmlCommand prend en charge plusieurs méthodes, notamment les méthodes suivantes pour l’exécution d’une commande :

void ExecuteNonQuery()
Exécute la commande, mais ne retourne rien. Cette méthode est utile si vous souhaitez exécuter une commande nonquery (autrement dit, une commande qui ne retourne rien). Par exemple, l’exécution d’un code de mise à jour ou d’un DiffGram qui met à jour les enregistrements, mais ne retourne rien.

Stream ExecuteStream()
Retourne un nouvel objet Stream. Cette méthode est utile lorsque vous souhaitez que les résultats de la requête vous soient renvoyés dans un nouveau flux. Pour obtenir un exemple de travail, consultez Exécution de requêtes SQL (classes managées SQLXML).

public void ExecuteToStream(Stream outputStream)
Écrit les résultats de la requête dans un flux existant. Cette méthode est utile lorsque vous avez un flux auquel vous avez besoin des résultats ajoutés (par exemple, pour que les résultats de la requête soient écrits dans System.Web.HttpResponse.OutputStream). Pour obtenir un exemple de travail, consultez Exécution de requêtes SQL (classes managées SQLXML).

XmlReader ExecuteXmlReader()
Retourne un objet XmlReader. Vous pouvez utiliser cette méthode pour manipuler des données dans l’objet XmlReader directement ou brancher l’architecture chaînable de System.Xml. Pour plus d’informations, consultez la documentation de Microsoft .NET Framework. Pour obtenir un exemple de travail, consultez Exécution de requêtes SQL à l’aide de la méthode ExecuteXMLReader.

L’objet TheSqlXmlCommand prend également en charge ces méthodes supplémentaires :

SqlXmlParameter CreateParameter()
Crée un objet SqlXmlParameter. Vous pouvez définir des valeurs pour les paramètres Nom et Valeur de cet objet. Cette méthode est utile si vous souhaitez passer des paramètres à une commande. Pour obtenir un exemple de travail, consultez Exécution de requêtes SQL (classes managées SQLXML).

void ClearParameters()
Efface les paramètres créés pour un objet de commande donné. Cette méthode est utile si vous souhaitez exécuter plusieurs requêtes sur le même objet de commande.

Propriétés

L’objet SqlXmlCommand prend également en charge ces propriétés :

ClientSideXml
Lorsque la valeur est True, spécifie que la conversion de l’ensemble de lignes en XML doit se produire sur le client au lieu du serveur. Cette propriété est utile lorsque vous souhaitez déplacer la charge de performances vers le niveau intermédiaire. La propriété vous permet également d’encapsuler les procédures stockées existantes avec FOR XML pour obtenir la sortie XML.

SchemaPath
Nom du schéma de mappage avec le chemin d’accès au répertoire (par exemple, C:\x\y\MySchema.xml). Cette propriété est utile pour spécifier un schéma de mappage pour les requêtes XPath. Le chemin spécifié peut être absolu ou relatif. Si le chemin d’accès est relatif, le chemin d’accès de base spécifié dans le chemin d’accès de base est utilisé pour résoudre le chemin relatif. Si aucun chemin de base n’est spécifié, le chemin relatif est relatif au répertoire actif. Pour obtenir un exemple de travail, consultez Accès aux fonctionnalités SQLXML dans l’environnement .NET.

XslPath
Nom du fichier XSL, ainsi que le chemin d’accès au répertoire. Le chemin spécifié peut être absolu ou relatif. Si le chemin d’accès est relatif, le chemin d’accès de base spécifié dans le chemin d’accès de base est utilisé pour résoudre le chemin relatif. Si aucun chemin de base n’est spécifié, le chemin relatif est relatif au répertoire actif. Pour obtenir un exemple de travail, consultez Application d’une transformation XSL (classes managées SQLXML).

Chemin d’accès de base
Chemin d’accès de base (chemin d’accès au répertoire). Cette propriété est utile pour résoudre un chemin d’accès relatif spécifié pour un fichier XSL (à l’aide de la propriété XslPath), un fichier de schéma de mappage (à l’aide de la propriété SchemaPath) ou une référence de schéma externe dans un modèle XML (spécifié à l’aide de l’attribut mapping-schema ).

OutputEncoding
Spécifie l’encodage du flux retourné lors de l’exécution de la commande. Cette propriété est utile pour demander un encodage spécifique pour le flux retourné. Certains encodages couramment utilisés sont UTF-8, ANSI et Unicode. UTF-8 est l’encodage par défaut.

Espaces de noms
Active l’exécution de requêtes XPath qui utilisent des espaces de noms. Pour plus d’informations sur les requêtes XPath avec des espaces de noms, consultez Exécution de requêtes XPath avec des espaces de noms (classes managées SQLXML). Pour obtenir un exemple de travail, consultez Exécution de requêtes XPath (classes managées SQLXML).

RootTag
Fournit l’élément racine unique pour XML généré par l’exécution de commandes. Un document XML valide nécessite une balise de niveau racine unique. Si la commande exécutée génère un fragment XML (sans élément de niveau supérieur unique), vous pouvez spécifier un élément racine pour le xml retourné. Pour obtenir un exemple de travail, consultez Application d’une transformation XSL (classes managées SQLXML).

CommandText
Texte de la commande. Cette propriété est utilisée pour spécifier le texte de la commande que vous souhaitez exécuter. Pour obtenir un exemple de travail, consultez Exécution de requêtes SQL (classes managées SQLXML).

CommandStream
Flux de commandes. Cette propriété est utile si vous souhaitez exécuter une commande à partir d’un fichier (par exemple, un modèle XML). Lorsque vous utilisez CommandStream, seules les valeurs « Template »,« UpdateGram » et « DiffGram » sont prises en charge. Pour obtenir un exemple de travail, consultez Exécution de fichiers de modèle à l’aide de la propriété CommandStream.

CommandType
Identifie le type de commande. Cette propriété est utilisée pour spécifier le type de commande que vous souhaitez exécuter. Les valeurs du tableau suivant déterminent le type de la commande. Pour obtenir un exemple de travail, consultez Accès aux fonctionnalités SQLXML dans l’environnement .NET.

Valeur	Descriptif
SqlXmlCommandType.Sql	Exécute une commande SQL (par exemple, SELECT * FROM Employees FOR XML AUTO).
SqlXmlCommandType.XPath	Exécute une commande XPath (par exemple, Employees[@EmployeeID=1]).
SqlXmlCommandType.Template	Exécute un modèle XML.
SqlXmlCommandType.TemplateFile	Exécute un fichier de modèle au chemin d’accès spécifié.
SqlXmlCommandType.UpdateGram	Exécute un code de mise à jour.
SqlXmlCommandType.Diffgram	Exécute un DiffGram.

Voir aussi

Objet SqlXmlParameter (classes managées SQLXML)
Objet SqlXmlAdapter (classes managées SQLXML)