Fonctions d’accesseur de données : string (XQuery)
S’applique à :
SQL Server
Retourne la valeur de $arg représentée sous forme de chaîne.
Syntaxe
fn:string() as xs:string
fn:string($arg as item()?) as xs:string
Arguments
$arg
Nœud ou valeur atomique.
Remarques
Si $arg est la séquence vide, la chaîne de longueur nulle est retournée.
Si $arg est un nœud, la fonction retourne la valeur de chaîne du nœud obtenue à l’aide de l’accesseur chaîne-valeur. Celui-ci est défini dans les spécifications W3C XQuery 1.0 et XPath 2.0 Data Model.
Si $arg est une valeur atomique, la fonction retourne la même chaîne que celle renvoyée par l’expression cast en tant que xs:string, $arg, sauf indication contraire.
Si le type de $arg est xs:anyURI, l’URI est converti en chaîne sans échappement de caractères spéciaux.
Dans cette implémentation, fn:string() sans argument ne peut être utilisé que dans le contexte d’un prédicat dépendant du contexte. Autrement dit, elle ne peut être utilisée qu'à l'intérieur de crochets ([ ]).
Exemples
Cette rubrique fournit des exemples XQuery par rapport aux instances XML stockées dans différentes colonnes de type XML dans la base de données AdventureWorks.
R. Utilisation de la fonction string
La requête suivante récupère le nœud d’élément enfant de l’élément><ProductDescription.<Features>
SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
/PD:ProductDescription/PD:Features
')
FROM Production.ProductModel
WHERE ProductModelID=19
Voici le résultat partiel :
<PD:Features xmlns:PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">
These are the product highlights.
<p1:Warranty xmlns:p1="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelWarrAndMain">
<p1:WarrantyPeriod>3 years</p1:WarrantyPeriod>
<p1:Description>parts and labor</p1:Description>
</p1:Warranty>
...
</PD:Features>
Si vous spécifiez la fonction string(), vous recevez la valeur de chaîne du nœud spécifié.
SELECT CatalogDescription.query('
declare namespace PD="https://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription";
string(/PD:ProductDescription[1]/PD:Features[1])
')
FROM Production.ProductModel
WHERE ProductModelID=19
Le résultat partiel est le suivant.
These are the product highlights.
3 yearsparts and labor...
B. Utilisation de la fonction string sur différents nœuds
Dans l'exemple suivant, une instance XML est affectée à une variable de type xml. Les requêtes sont spécifiées pour illustrer le résultat de l’application de string() à différents nœuds.
declare @x xml
set @x = '<?xml version="1.0" encoding="UTF-8" ?>
<!-- This is a comment -->
<root>
<a>10</a>
just text
<b attr="x">20</b>
</root>
'
La requête suivante extrait la valeur de chaîne du nœud de document. Cette valeur est le fruit de la concaténation de la valeur de chaîne de tous ses nœuds de texte descendants.
select @x.query('string(/)')
Voici le résultat obtenu :
This is a comment 10
just text
20
La requête suivante essaie d'extraire la valeur de chaîne d'un nœud d'instruction de traitement. Le résultat est une séquence vide, car il ne contient pas de nœud de texte.
select @x.query('string(/processing-instruction()[1])')
La requête suivante extrait la valeur de chaîne du nœud de commentaire et renvoie le nœud de texte.
select @x.query('string(/comment()[1])')
Voici le résultat obtenu :
This is a comment