CommandText プロパティを使用した、テンプレート ファイルの実行

この例では、SQL または XPath クエリで構成されるテンプレート ファイルを、CommandText プロパティを使って指定する方法を示します。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;
      }
   }

アプリケーションをテストするには

この例をテストするには、コンピュータに Microsoft .NET Framework がインストールされている必要があります。

1. この例で提供される XML テンプレート (TemplateFile.xml) をフォルダに保存します。

2. この例で提供される C# コード (DocSample.cs) を、スキーマと同じフォルダに保存します。ファイルを別のフォルダに保存する場合は、コードを編集して、マッピング スキーマに対する適切なディレクトリ パスを指定する必要があります。

3. コードをコンパイルします。コマンド プロンプトでコードをコンパイルするには、次を使用します。

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

   これにより、実行可能ファイル (DocSample.exe) が作成されます。

4. コマンド プロンプトで、DocSample.exe を実行します。

テンプレートにパラメータを渡す場合は、パラメータ名を記号 (@) で始める必要があります。たとえば、p.Name="@ContactID" のように指定します。p は SqlXmlParameter オブジェクトです。

次は、1 つのパラメータをとるように変更したテンプレートです。

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