Partager via


ToString (moteur de base de données)

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Retourne une chaîne avec la représentation logique de this. ToString est appelée implicitement quand une conversion de hierarchyid en un type chaîne se produit. Agit comme l’opposé de Analyser (Moteur de base de données).

Syntaxe

-- Transact-SQL syntax
node.ToString  ( )
-- This is functionally equivalent to the following syntax  
-- which implicitly calls ToString():  
CAST(node AS nvarchar(4000))  
-- CLR syntax
string ToString  ( )

Types de retour

Type de retour SQL Server : nvarchar(4000)

Type de retour CLR : String

Notes

Retourne l'emplacement logique dans la hiérarchie. Par exemple, /2/1/ représente la quatrième ligne (Microsoft SQL Server) de la structure hiérarchique suivante d’un système de fichiers :

/        C:\  
/1/      C:\Database Files  
/2/      C:\Program Files  
/2/1/    C:\Program Files\Microsoft SQL Server  
/2/2/    C:\Program Files\Microsoft Visual Studio  
/3/      C:\Windows  

Exemples

R. Exemple Transact-SQL dans une table

L’exemple suivant retourne la colonne OrgNode à la fois comme un type de données hierarchyid et sous un format de chaîne plus lisible :

SELECT OrgNode,  
OrgNode.ToString() AS Node  
FROM HumanResources.EmployeeDemo  
ORDER BY OrgNode ;  
GO  

Voici le jeu de résultats.

OrgNode   Node  
0x        /  
0x58      /1/  
0x5AC0    /1/1/  
0x5B40    /1/2/  
0x5BC0    /1/3/  
0x5C20    /1/4/  
...  

B. Conversion de valeurs Transact-SQL sans table

L’exemple de code suivant utilise ToString pour convertir une valeur hierarchyid en une chaîne et Parse pour convertir une valeur de chaîne en hierarchyid.

DECLARE @StringValue AS nvarchar(4000), @hierarchyidValue AS hierarchyid  
SET @StringValue = '/1/1/3/'  
SET @hierarchyidValue = 0x5ADE  
  
SELECT hierarchyid::Parse(@StringValue) AS hierarchyidRepresentation,  
@hierarchyidValue.ToString() AS StringRepresentation ;
GO  

Voici le jeu de résultats.

hierarchyidRepresentation    StringRepresentation
-------------------------    -----------------------
0x5ADE                       /1/1/3/

C. Exemple CLR

L’extrait de code suivant appelle la méthode ToString() :

this.ToString()  

Voir aussi

Référence de méthodes de type de données hierarchyid
Données hiérarchiques (SQL Server)
hierarchyid (Transact-SQL)