共用方式為


存取 .NET 環境中的 SQLXML 功能

此範例顯示:

  • 如何使用 Microsoft SQLXML Managed 類別 (Microsoft.Data.SqlXml) 存取 Microsoft .NET Framework 環境中的 Microsoft SQL Server。

  • 在 .NET Framework 環境中產生的 DiffGrams 如何將資料更新套用到 SQL Server 資料表。

在此應用程式中,XPath 查詢會根據 XSD 結構描述執行。 XPath 查詢的執行會傳回包含連絡人資料 (FirstNameLastName) 的 XML 文件。 應用程式會將 XML 文件載入到 .NET Framework 環境的資料集中。 資料集中的資料已修改:連絡人的名字會變更為 "Susan",成為資料集中的第一個連絡人。 DiffGram 會從資料集產生,然後會將 DiffGram (員工名字的變更) 中指定的更新套用到 Person.Contact 資料表。

[!附註]

在程式碼中,您必須於連接字串內提供 SQL Server 執行個體的名稱。

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;
   }
}

測試範例:

若要測試此範例,您必須先在電腦上安裝 Microsoft .NET Framework。

  1. 將這個 XSD 結構描述 (MySchema.xml) 儲存在資料夾中:

    <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. 將此範例中提供的 C# 程式碼 (DocSample.cs) 儲存到儲存結構描述的相同資料夾中 (如果您將檔案儲存在不同的資料夾中,您將需要編輯程式碼,然後為對應的結構描述指定適當的目錄路徑)。

  3. 編譯程式碼。 若要在命令提示字元中編譯程式碼,請使用:

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

    這樣會建立一個可執行檔 (DocSample.exe)。

在命令提示字元中執行 DocSample.exe。