共用方式為

執行含有命名空間的 XPath 查詢 (SQLXML Managed 類別)

  • 發行項

XPath 查詢可以包含命名空間。 如果結構描述元素會限定命名空間 (使用目標命名空間)，針對此結構描述進行的 XPath 查詢就必須指定此命名空間。

由於 Microsoft SQLXML 4.0 不支援萬用字元 (*)，所以您必須使用命名空間前置詞來指定 XPath 查詢。 若要解析此前置詞，請使用 namespaces 屬性來指定命名空間繫結。

在下列範例中，XPath 查詢會使用萬用字元 (*) 和 local-name() 與 namespace-uri() XPath 函數來指定命名空間。 這個 XPath 查詢會傳回本機名稱為 Employee 而且命名空間 URI 為 urn:myschema:Contacts 的所有元素：

/*[local-name() = 'Contact' and namespace-uri() = 'urn:myschema:Contacts']

在 SQLXML 4.0 中，使用命名空間前置詞來指定這個 XPath 查詢。 例如，x:Contact，其中 x 是命名空間前置詞。 請考慮下列 XSD 結構描述：

<schema xmlns="http://www.w3.org/2001/XMLSchema"
            xmlns:sql="urn:schemas-microsoft-com:mapping-schema"
            xmlns:con="urn:myschema:Contacts"
            targetNamespace="urn:myschema:Contacts">
<complexType name="ContactType">
  <attribute name="CID" sql:field="ContactID" type="ID"/>
  <attribute name="FName" sql:field="FirstName" type="string"/>
  <attribute name="LName" sql:field="LastName"/> 
</complexType>
<element name="Contact" type="con:ContactType" sql:relation="Person.Contact"/>
</schema>

由於這個結構描述會定義目標命名空間，所以針對此結構描述進行的 XPath 查詢 (例如 "Employee") 必須包含該命名空間。

下列 C# 範例應用程式會針對先前的 XSD 結構描述 (MySchema.xml) 執行 XPath 查詢。 若要解析此前置詞，使用 SqlXmlCommand 物件的 Namespaces 屬性來指定命名空間繫結。

[!附註]

在程式碼中，您必須於連接字串內提供 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 testXPath()
      {
         //Stream strm;
         SqlXmlCommand cmd = new SqlXmlCommand(ConnString);
         cmd.CommandText = "x:Contact[@CID='1']";
         cmd.CommandType = SqlXmlCommandType.XPath;
         cmd.RootTag = "ROOT";
         cmd.Namespaces = "xmlns:x='urn:myschema:Contacts'";
         cmd.SchemaPath = "MySchema.xml";
         using (Stream strm = cmd.ExecuteStream()){
            using (StreamReader sr = new StreamReader(strm)){
               Console.WriteLine(sr.ReadToEnd());
            }
         }
         return 0;
      }
      public static int Main(String[] args)
      {
         testXPath();
         return 0;
      }
   }

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

若要測試應用程式

  1. 將這個範例所提供的 XSD 結構描述 (MySchema.xml) 儲存在資料夾中。

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

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

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

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

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