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 示例,这些实例存储在 AdventureWorks2012 数据库内不同的 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

请参阅

概念

与 QName 相关的函数 (XQuery)