ToString (database-engine)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric Preview

Retourneert een tekenreeks met de logische weergave van deze. ToString wordt impliciet aangeroepen wanneer een conversie van hiërarchie-id naar een tekenreekstype plaatsvindt. Fungeert als het tegenovergestelde van parseren (database-engine).

Syntax

-- 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  ( )

Return types

SQL Server-retourtype:nvarchar(4000)

CLR-retourtype: Tekenreeks

Remarks

Retourneert de logische locatie in de hiërarchie. /2/1/ vertegenwoordigt bijvoorbeeld de vierde rij (Microsoft SQL Server) in de volgende hiërarchische structuur van een bestandssysteem:

/        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  

Examples

A. Transact-SQL voorbeeld in een tabel

In het volgende voorbeeld worden zowel de OrgNode kolom geretourneerd als zowel de hiërarchie-id gegevenstype als in de meer leesbare tekenreeksindeling:

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

Dit is de resultatenset.

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

B. Transact-SQL waarden zonder tabel converteren

In het volgende codevoorbeeld wordt ToString gebruikt om een hiërarchie-id waarde te converteren naar een tekenreeks en Parse om een tekenreekswaarde te converteren naar een hiërarchie-id.

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  

Dit is de resultatenset.

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

C. CLR example

Met het volgende codefragment wordt de methode ToString() aangeroepen:

this.ToString()  

See also

gegevenstype van de hiërarchie-id
Hierarchical Data (SQL Server)
hierarchyid (Transact-SQL)