local-name-from-QName (XQuery)

Devuelve un xs:NCNAME que representa la parte local del QName especificado por $arg. El resultado es una secuencia vacía si $arg es la secuencia vacía.

Sintaxis

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

Argumentos

  • $arg
    Es el QName del que se debería extraer el nombre local.

Ejemplos

En este tema se ofrecen ejemplos de XQuery con instancias XML almacenadas en varias columnas de tipo xml en la base de datos AdventureWorks. Para obtener información general de cada una de estas columnas, vea Representación de tipo de datos xml en la base de datos AdventureWorks.

En el ejemplo siguiente, se utiliza la función local-name-from-QName() para recuperar el nombre local y el URI de espacio de nombres a partir de un valor de tipo QName. En el ejemplo, se realizan las tareas siguientes:

  • Crear una colección de esquemas XML.
  • Crear una tabla con una columna de tipo xml. El tipo xml se escribe utilizando la colección de esquemas XML.
  • Almacenar una instancia XML de ejemplo en la tabla. Mediante el método query() del tipo datos xml, la expresión de consulta se ejecuta para recuperar la parte de nombre local del valor de tipo QName de la instancia.
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

Vea también

Conceptos

Funciones relacionadas con QNames (XQuery)

Ayuda e información

Obtener ayuda sobre SQL Server 2005