Partilhar via


Funções Relacionadas a QNames – local-name-from-QName

Aplica-se: SQL Server

Retorna um xs:NCNAME que representa a parte local do QName especificada por $arg. O resultado é uma sequência vazia se $arg for a sequência vazia.

Sintaxe

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

Argumentos

$arg
É do QName que o nome local deveria ser extraído.

Exemplos

Este tópico fornece exemplos de XQuery em instâncias XML armazenadas em várias colunas de tipo xml no AdventureWorks2022 banco de dados.

O exemplo a seguir usa a função local-name-from-QName() para recuperar o nome local e as partes do URI do namespace de um valor de tipo QName. O exemplo executa o seguinte:

  • Cria uma coleção de esquemas XML.

  • Cria uma tabela com uma coluna do tipo xml. O tipo xml é digitado usando a coleção de esquemas XML.

  • Armazena uma instância XML de exemplo na tabela. Usando o método query() do tipo de dados xml, a expressão de consulta é executada para recuperar a parte do nome local do valor do tipo QName da instância.

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  

Confira também

Funções relacionadas a QNames (XQuery)