Fonctions relatives aux QName - nom local de QNameFunctions Related to QNames - local-name-from-QName

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse nonParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Retourne un xs : NCName qui représente la partie locale de QName indiquée par $arg.Returns an xs:NCNAME that represents the local part of QName specified by $arg. Le résultat est une séquence vide si $arg est la séquence vide.The result is an empty sequence if $arg is the empty sequence.

SyntaxeSyntax

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

ArgumentsArguments

$arg$arg
QName d'où le nom local doit être extrait.Is the QName that the local name should be extracted from.

ExemplesExamples

Cette rubrique fournit des exemples de XQuery relatifs à des instances XML stockés dans différentes xml type des colonnes dans le AdventureWorks2012AdventureWorks2012 base de données.This topic provides XQuery examples against XML instances that are stored in various xml type columns in the AdventureWorks2012AdventureWorks2012 database.

L’exemple suivant utilise le local-name-from-QName() fonction pour récupérer le nom local et l’URI d’espace de noms de pièces à partir d’une valeur de type QName.The following example uses the local-name-from-QName() function to retrieve the local name and namespace URI parts from a QName type value. Cet exemple illustre les opérations suivantes :The example performs the following:

  • La requête crée une collection de schémas XML.Creates an XML schema collection.

  • Elle crée ensuite une table possédant une colonne de type xml.Creates a table with an xml type column. Ce type est typé par le biais de la collection de schémas XML.The xml type is typed using the XML schema collection.

  • Elle stocke enfin une instance XML servant d'échantillon dans la table.Stores a sample XML instance in the table. À l’aide de la query() méthode du type de données xml, l’expression de requête est exécutée pour récupérer la partie nom local de la valeur de type QName à partir de l’instance.Using the query() method of the xml data type, the query expression is executed to retrieve the local name part of the QName type value from the instance.

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  

Voir aussiSee Also

Fonctions relatives aux QName ( XQuery )Functions Related to QNames (XQuery)