• 發行項

使用 SQLXML Managed 類別執行 DiffGram

此範例會示範如何使用 SQLXML Managed 類別 (Microsoft.Data.SqlXml) 在 Microsoft .NET Framework 環境中執行 DiffGram 檔案，以便將資料更新套用到 SQL Server 資料表。

在此範例中，DiffGram 會更新客戶 ALFKI 的客戶資訊 (CompanyName 和 ContactName)。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql" sql:mapping-schema="DiffGramSchema.xml">
  <diffgr:diffgram 
           xmlns:msdata="urn:schemas-microsoft-com:xml-msdata" 
           xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">
    <DataInstance>
      <Customer diffgr:id="Customer1" 
                msdata:rowOrder="0" diffgr:hasChanges="modified" 
                CustomerID="ALFKI">
          <CompanyName>Bottom Dollar Markets</CompanyName>
          <ContactName>Antonio Moreno</ContactName>
      </Customer>
    </DataInstance>
    <diffgr:before>
     <Customer diffgr:id="Customer1" 
               msdata:rowOrder="0" 
               CustomerID="ALFKI">
        <CompanyName>Alfreds Futterkiste</CompanyName>
        <ContactName>Maria Anders</ContactName>
      </Customer>
    </diffgr:before>
  </diffgr:diffgram>
</ROOT>

<before> 區塊包含一個 <Customer> 元素 (diffgr:id="Customer1")。<DataInstance> 區塊包含擁有相同 id 的對應 <Customer> 元素。<NewDataSet> 中的 <customer> 元素也會指定 diffgr:hasChanges="modified"。這表示更新作業，而且 Cust 資料表中的客戶記錄也會隨之更新。請注意，如果未指定 diffgr:hasChanges 屬性，DiffGram 處理邏輯會忽略這個元素，而且不會執行任何更新。

以下為 C# 教學課程應用程式的程式碼，可示範如何使用 SQLXML Managed 類別執行以上的 DiffGram，並更新您也會在 tempdb 資料表中建立的兩個資料表 (Cust、Ord)。

using System;
using System.Data;
using Microsoft.Data.SqlXml;
using System.IO;
class Test
{
   static string ConnString = "Provider=SQLOLEDB;Server=MyServer;database=tempdb;Integrated Security=SSPI;";
   public static int testParams()
   {
      SqlXmlAdapter ad;
      // Need a memory stream to hold diff gram temporarily
      MemoryStream ms = new MemoryStream();
      SqlXmlCommand cmd = new SqlXmlCommand(ConnString);
      cmd.RootTag = "ROOT";
      cmd.CommandStream = new FileStream("MyDiffgram.xml", FileMode.Open, FileAccess.Read);
      cmd.CommandType = SqlXmlCommandType.DiffGram;
      cmd.SchemaPath = "DiffGramSchema.xml";
      // Load data set
      DataSet ds = new DataSet();
      ad = new SqlXmlAdapter(cmd);
      ad.Fill(ds);
      ad.Update(ds);
      return 0;
   }
   public static int Main(String[] args)
   {
      testParams();
      return 0;
   }
}

測試應用程式

  1. 確認用戶端電腦上是否安裝 .NET Framework。

  2. 將下列 XSD 結構描述 (DiffGramSchema.xml) 儲存在資料夾中：

    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema">
 <xsd:annotation>
  <xsd:documentation>
    Diffgram Customers/Orders Schema.
  </xsd:documentation>
  <xsd:appinfo>
       <sql:relationship name="CustomersOrders" 
                  parent="Cust"
                  parent-key="CustomerID"
                  child-key="CustomerID"
                  child="Ord"/>
  </xsd:appinfo>
 </xsd:annotation>
 <xsd:element name="Customer" sql:relation="Cust">
  <xsd:complexType>
    <xsd:sequence>
      <xsd:element name="CompanyName"    type="xsd:string"/>
      <xsd:element name="ContactName"    type="xsd:string"/>
       <xsd:element name="Order" sql:relation="Ord" sql:relationship="CustomersOrders">
        <xsd:complexType>
          <xsd:attribute name="OrderID" type="xsd:int" sql:field="OrderID"/>
          <xsd:attribute name="CustomerID" type="xsd:string"/>
        </xsd:complexType>
      </xsd:element>
    </xsd:sequence>
    <xsd:attribute name="CustomerID" type="xsd:string" sql:field="CustomerID"/>
  </xsd:complexType>
 </xsd:element>
</xsd:schema>

  3. 在 tempdb 資料庫中建立這些資料表。

    CREATE TABLE Cust(
        CustomerID  nchar(5) Primary Key,
        CompanyName nvarchar(40) NOT NULL ,
        ContactName nvarchar(60) NULL)
GO

CREATE TABLE Ord(
   OrderID    int Primary Key,
   CustomerID nchar(5) Foreign Key REFERENCES Cust(CustomerID))
GO

  4. 加入這個範例資料：

    INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES
     (N'ALFKI', N'Alfreds Futterkiste', N'Maria Anders')
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES
     (N'ANATR', N'Ana Trujillo Emparedados y helados', N'Ana Trujillo')
INSERT INTO Cust(CustomerID, CompanyName, ContactName) VALUES
     (N'ANTON', N'Antonio Moreno Taquería', N'Antonio Moreno')

INSERT INTO Ord(OrderID, CustomerID) VALUES(1, N'ALFKI')
INSERT INTO Ord(OrderID, CustomerID) VALUES(2, N'ANATR')
INSERT INTO Ord(OrderID, CustomerID) VALUES(3, N'ANTON')

  5. 複製上述的 DiffGram，並將其貼到文字檔中。然後在步驟 1 所使用的相同資料夾中，將檔案儲存為 MyDiffGram.xml。

  6. 將以上提供的 C# 程式碼 (DiffgramSample.cs) 儲存在上述步驟中儲存 DiffGramSchema.xml 和 MyDiffGram.xml 所在的相同資料夾中。

    [!附註]

    您需要將連接字串中的 SQL Server 執行個體名稱從 'MyServer' 更新為已安裝之 SQL Server 執行個體的實際名稱。

    如果您將檔案儲存在不同的資料夾中，您將需要編輯程式碼，然後為對應的結構描述指定適當的目錄路徑。

  7. 編譯程式碼。若要在命令提示字元中編譯程式碼，請使用：

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

    這樣會建立可執行檔 (DiffgramSample.exe)。

  8. 在命令提示字元中，執行 DiffgramSample.exe。

請參閱

參考

DiffGram 範例 (SQLXML 4.0)