共用方式為


與 QNames 相關的函式 - local-name-from-QName

適用於:SQL Server

會傳回 xs:NCNAME,代表$arg指定 QName 的本機部分。 如果 $arg 是空序列,則結果是空序列。

語法

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

引數

$arg
這是應該從中擷取本機名稱的 QName。

範例

本主題針對儲存在資料庫中各種 xml 類型數據行中的 AdventureWorks2022 XML 實例,提供 XQuery 範例。

下列範例會使用 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="https://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 retrieve 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 = https://someURI  

另請參閱

與 QNames 相關的函式 (XQuery)