執行含有命名空間的 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
測試這個應用程式
將範例 XSD 結構描述儲存在資料夾中。
建立 Visual Basic 可執行檔專案,然後將程式碼複製到其中。依適當情況變更指定的目錄路徑。
加入下列專案參考:
"Microsoft ActiveX Data Objects 2.8 Library"
執行應用程式。
以下是部分結果:
<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 結構描述)>。