Partager via


ToString (moteur de base de données)

Retourne une chaîne avec la représentation logique de this. ToString est appelé implicitement lorsqu'une conversion de hierarchyid en un type de chaîne se produit. Agit comme l'opposé de Parse (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 des valeurs 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) dans 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

A. Exemple Transact-SQL dans une table

L'exemple suivant retourne la colonne OrgNode dans 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 l'ensemble des 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 un 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 l'ensemble des résultats.

hierarchyidRepresentation StringRepresentation

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

0x5ADE /1/1/3/

C. Exemple CLR

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

this.ToString()