Fonctions sur des valeurs de chaîne - majusculesFunctions on String Values - upper-case

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

Cette fonction convertit chaque caractère dans $arg à son équivalent en majuscule.This function converts each character in $arg to its upper case equivalent. La conversion de casse binaire de Microsoft Windows pour les points de code Unicode spécifie le mode de conversion des caractères en majuscules.The Microsoft Windows binary case conversion for Unicode code points specifies how characters are converted to upper case. Cette norme est différente du mappage de la norme des points de code Unicode.This standard is different than the mapping for Unicode standard code point standard.

SyntaxeSyntax


fn:upper-case($arg as xs:string?) as xs:string  

ArgumentsArguments

TermeTerm DéfinitionDefinition
$arg$arg Valeur de chaîne à convertir en majuscule.The string value to be converted to upper case.

NotesRemarks

Si la valeur de $arg est vide, une chaîne de longueur nulle est retournée.If the value of $arg is empty, a zero length string is returned.

ExemplesExamples

A.A. Conversion d'une chaîne en majuscules.Changing a string to upper case

L’exemple suivant modifie la chaîne d’entrée ' abcDEF ! @4' en majuscules.The following example changes the input string 'abcDEF!@4' to upper case.

DECLARE @x xml = N'abcDEF!@4';  
SELECT @x.value('fn:upper-case(/text()[1])', 'nvarchar(10)');  

B.B. Recherche d'une chaîne de caractères spécifiqueSearch for a Specific Character String

Cet exemple montre comment utiliser la fonction upper-case pour effectuer une recherche non sensible à la casse.This example shows how to use the upper-case function to perform a case-insensitive search.

USE AdventureWorks  
GO  
--WITH XMLNAMESPACES clause specifies the namespace prefix  
--to use.   
WITH XMLNAMESPACES ('http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription' AS pd)  
--The XQuery contains() function is used to determine whether  
--any of the text nodes below the <Summary> element contain  
--the word 'frame'. The upper-case() function is used to make  
--the search case-insensitive.  

SELECT ProductModelID, CatalogDescription.query('  
      <Prod>  
         { /pd:ProductDescription/@ProductModelID }  
         { /pd:ProductDescription/pd:Summary }  
      </Prod>  
 ') as Result  
FROM Production.ProductModel  
where CatalogDescription.exist('  
/pd:ProductDescription/pd:Summary//text()[  
          contains(upper-case(.), "FRAME")]')  = 1  

Voici l'ensemble des résultats.Here is the result set.

ProductModelID Result

-------------- ---------

19 <Prod ProductModelID="19">

<pd:Summary xmlns:pd="http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">

<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">Our top-of-the-line competition mountain bike.

Performance-enhancing options include the innovative HL Frame,

super-smooth front suspension, and traction for all terrain.

</p1:p>

</pd:Summary>

</Prod>

25 <Prod ProductModelID="25">

<pd:Summary xmlns:pd="http://schemas.microsoft.com/sqlserver/2004/07/adventure-works/ProductModelDescription">

<p1:p xmlns:p1="http://www.w3.org/1999/xhtml">This bike is ridden by race winners. Developed with the

Adventure Works Cycles professional race team, it has a extremely light

heat-treated aluminum frame, and steering that allows precision control.

</p1:p>

</pd:Summary>

</Prod>

Voir aussiSee Also

Fonctions XQuery impliquant le type de données xmlXQuery Functions against the xml Data Type