使用 CommandText 屬性執行範本檔案

這個範例說明如何使用 CommandText 屬性來指定由 SQL 或 XPath 查詢所組成的範本檔案。您可以將檔案名稱指定為 CommandText 的值，而不是將 SQL 或 XPath 查詢指定為它的值。在下列範例中，CommandType 屬性會指定為 SqlXmlCommandType.TemplateFile。

此範例應用程式會執行此範本：

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:query>
    SELECT TOP 2 ContactID, FirstName, LastName 
    FROM   Person.Contact
    FOR XML AUTO
  </sql:query>
</ROOT>

這是 C# 應用程式範例。若要測試應用程式，請儲存範本 (TemplateFile.xml)，然後再執行應用程式。

[!附註]

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

using System;
using Microsoft.Data.SqlXml;
using System.IO;
class Test
{
      static string ConnString = "Provider=SQLOLEDB;Server=(local);database=AdventureWorks;Integrated Security=SSPI";

      public static int testParams()
      {
         //Stream strm;
         SqlXmlCommand cmd = new SqlXmlCommand(ConnString);
         cmd.CommandType = SqlXmlCommandType.TemplateFile;
         cmd.CommandText = "TemplateFile.xml";
         using (Stream strm = cmd.ExecuteStream()){
            using (StreamReader sr = new StreamReader(strm)){
                Console.WriteLine(sr.ReadToEnd());
            }
         }

         return 0;      
      }
      public static int Main(String[] args)
      {
         testParams();   
         return 0;
      }
   }

測試應用程式

1. 請確認您在電腦上已安裝 Microsoft .NET Framework。

2. 將這個範例所提供的 XML 範本 (TemplateFile.xml) 儲存在資料夾中。

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

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

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

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

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

如果您將參數傳遞給範本，參數名稱必須以 At 符號 (@) 開頭；例如 p.Name="@ContactID"，其中 p 是 SqlXmlParameter 物件。

這是採用一個參數的已更新範本。

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql">
  <sql:header>
     <sql:param name='ContactID'>1</sql:param>  
  </sql:header>
  <sql:query>
    SELECT ContactID, FirstName, LastName
    FROM   Person.Contact
    WHERE  ContactID=@ContactID
    FOR XML AUTO
  </sql:query>
</ROOT>

這是已更新的程式碼，會將參數傳入其中來執行範本。

   public static int testParams()
   {

      Stream strm;
      SqlXmlParameter p;

      SqlXmlCommand cmd = new SqlXmlCommand(ConnString);
      cmd.CommandType = SqlXmlCommandType.TemplateFile;
      cmd.CommandText = "TemplateFile.xml";
      p = cmd.CreateParameter();
      p.Name="@ContactID";
      p.Value = "1";
      strm = cmd.ExecuteStream();
      StreamReader sw = new StreamReader(strm);
      Console.WriteLine(sw.ReadToEnd());
      return 0;      
   }