共用方式為


執行含有命名空間的 XPath 查詢 (SQLXMLOLEDB 提供者)

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

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

在下列範例中,XPath 查詢會使用萬用字元 (*) 和 local-name()namespace-uri() XPath 函數來指定命名空間。這個 XPath 查詢會傳回本機名稱為 Contact 而且命名空間 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") 必須包含該命名空間。

這是針對上述 XSD 結構描述執行 XPath 查詢 (x:Employee) 的範例 Microsoft Visual Basic 應用程式。若要解析此前置詞,您可以使用 namespaces 屬性來指定命名空間繫結。

[!附註]

在程式碼中,您必須於連接字串內提供 SQL Server 執行個體的名稱。此外,這個範例會指定針對資料提供者使用 SQL Server Native Client (SQLNCLI10) (需要安裝其他網路用戶端軟體)。如需詳細資訊,請參閱<SQL Server 2008 Native Client 的系統需求>。

Option Explicit
Private Sub Form_Load()
    Dim con As New ADODB.Connection
    Dim cmd As New ADODB.Command
    Dim stm As New ADODB.Stream
    con.Open "provider=SQLXMLOLEDB.4.0;Data Provider=SQLNCLI10;Data Source=SqlServerName;Initial Catalog=AdventureWorks;Integrated Security=SSPI;"
    Set cmd.ActiveConnection = con
    stm.Open
    cmd.Properties("Output Stream").Value = stm
    cmd.Properties("Output Encoding") = "utf-8"
    cmd.Properties("Mapping schema") = "C:\DirectoryPath\con-ex.xml"
    cmd.Properties("namespaces") = "xmlns:x='urn:myschema:Contacts'"
    '  Debug.Print "Set Command Dialect to DBGUID_XPATH"
    cmd.Dialect = "{ec2a4293-e898-11d2-b1b7-00c04f680c56}"
    cmd.CommandText = "x:Contact"
    cmd.Execute , , adExecuteStream 
    stm.Position = 0
    Debug.Print stm.ReadText(adReadAll)
End Sub

測試這個應用程式

  1. 將範例 XSD 結構描述儲存在資料夾中。

  2. 建立 Visual Basic 可執行檔專案,然後將程式碼複製到其中。依適當情況變更指定的目錄路徑。

  3. 加入下列專案參考:

    "Microsoft ActiveX Data Objects 2.8 Library"
    
  4. 執行應用程式。

以下是部分結果:

<y0:Employee xmlns:y0="urn:myschema:Contacts" 
             LName="Achong" CID="1" FName="Gustavo"/>
<y0:Employee xmlns:y0="urn:myschema:Employees" 
             LName="Abel" CID="2" FName="Catherine"/>

雖然在 XML 文件中產生的前置詞是任意的,但是它們會對應至相同的命名空間。

如需有關在 XDR 結構描述中指定目標命名空間的詳細資訊,請參閱<使用 sql:target-namespace 指定目標命名空間 (XDR 結構描述)>。