local-name-from-QName (XQuery)

傳回 xs:NCNAME,以代表 $arg 所指定的 QName 之本機部份。如果 $arg 是空白時序,則結果將會是空白時序。

語法

fn:local-name-from-QName($arg as xs:QName?) as xs:NCName?

引數

  • $arg
    應該擷取本機名稱的來源 QName。

範例

本主題是針對 XML 執行個體提供 XQuery 範例,這些執行個體是儲存在 AdventureWorks 資料庫的數個 xml 類型資料行中。如需這些資料行中每個資料行的概觀,請參閱<在 AdventureWorks 資料庫中的 xml 資料類型表示法>。

下列範例使用 local-name-from-QName() 函數從 QName 類型值擷取本機名稱和命名空間 URI 部份。本範例將執行下列動作:

  • 建立 XML 結構描述集合。

  • 建立資料表以及 xml 類型資料行。xml 類型是使用 XML 結構描述集合來設定其類型。

  • 在資料表中儲存範例 XML 執行個體。使用 xml 資料類型的 query() 方法,將會執行查詢運算式以便從該執行個體擷取 QName 類型值的本機名稱部份。

DROP TABLE T
go
DROP XML SCHEMA COLLECTION SC
go
CREATE XML SCHEMA COLLECTION SC AS '
<schema xmlns="http://www.w3.org/2001/XMLSchema"
targetNamespace="QNameXSD" >
      <element name="root" type="QName" nillable="true"/>
</schema>'
go
 
CREATE TABLE T (xmlCol XML(SC))
go
-- following OK
insert into T values ('<root xmlns="QNameXSD" xmlns:a="http://someURI">a:someLocalName</root>')
 go
-- Retrieve the local name. 
SELECT xmlCol.query('declare default element namespace "QNameXSD"; local-name-from-QName(/root[1])')
FROM T
-- Result = someLocalName
-- You can retrive namespace URI part from the QName using the namespace-uri-from-QName() function
SELECT xmlCol.query('declare default element namespace "QNameXSD"; namespace-uri-from-QName(/root[1])')
FROM T
-- Result = http://someURI