Accès aux fonctionnalités SQLXML dans l'environnement .NET

Cet exemple montre :

• Comment utiliser les classes managées SQLXML Microsoft (Microsoft.Data.SqlXml) pour accéder à Microsoft SQL Server dans l'environnement Microsoft .NET Framework.

• Comment les DiffGrams générés dans l'environnement .NET Framework peuvent appliquer les mises à jour des données aux tables SQL Server.

Dans cette application, une requête XPath est exécutée sur un schéma XSD. L'exécution de la requête XPath retourne un document XML qui consiste en données de contact (FirstName, LastName). L'application charge le document XML dans le dataset de l'environnement .NET Framework. Les données du dataset sont modifiées : le prénom du contact est changé en « Susan » pour le premier contact du dataset. Le DiffGram est généré à partir du dataset, puis la mise à jour spécifiée dans le DiffGram (modification du prénom de l'employé) est appliquée à la table Person.Contact.

[!REMARQUE]

Dans le code, vous devez fournir le nom de l'instance de SQL Server dans la chaîne de connexion.

using System;
using System.Data;
using Microsoft.Data.SqlXml;
using System.IO;
class Test
{
   static string ConnString = "Provider=SQLOLEDB;Server=SqlServerName;database=AdventureWorks;Integrated Security=SSPI;";
   public static int testParams()
   {
      DataRow row;
      SqlXmlAdapter ad;
      //need a memory stream to hold diff gram temporarily
      MemoryStream ms = new MemoryStream();
      SqlXmlCommand cmd = new SqlXmlCommand(ConnString);
      cmd.RootTag = "ROOT";
      cmd.CommandText = "Con";
      cmd.CommandType = SqlXmlCommandType.XPath;
      cmd.SchemaPath = "MySchema.xml";
      //load data set
      DataSet ds = new DataSet();
      ad = new SqlXmlAdapter(cmd);
      ad.Fill(ds);
      row = ds.Tables["Con"].Rows[0];
      row["FName"] = "Susan";
      ad.Update(ds);
      return 0;
   }
   public static int Main(String[] args)
   {
      testParams();
      return 0;
   }
}

Pour tester l'exemple :

Pour tester cet exemple, Microsoft .NET Framework doit être installé sur votre ordinateur.

1. Enregistrez ce schéma XSD (MySchema.xml) dans un dossier :

   <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
               xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
     <xsd:element name="Con" sql:relation="Person.Contact" >
      <xsd:complexType>
        <xsd:sequence>
           <xsd:element name="FName"  
                        sql:field="FirstName" 
                        type="xsd:string" /> 
           <xsd:element name="LName"  
                        sql:field="LastName"  
                        type="xsd:string" />
        </xsd:sequence>
        <xsd:attribute name="ContactID" type="xsd:integer" />
       </xsd:complexType>
     </xsd:element>
   </xsd:schema>
   

2. Enregistrez le code C# (DocSample.cs) fourni dans cet exemple dans le même dossier que celui du schéma. (Si vous stockez les fichiers dans un dossier différent, vous devrez modifier le code et spécifier le chemin d'accès approprié au répertoire pour le schéma de mappage.)

3. Compilez le code. Pour compiler le code à l'invite de commandes, utilisez :

   csc /reference:Microsoft.Data.SqlXML.dll DocSample.cs
   

   Un fichier exécutable (DocSample.exe) est alors créé.

À l'invite de commandes, exécutez DocSample.exe.