ToString (Datenbank-Engine)

Gilt für:SQL ServerAzure SQL-Datenbankazure SQL Managed InstanceSQL-Datenbank in Microsoft Fabric

Gibt eine Zeichenfolge mit der logischen Darstellung von this zurück. ToString wird implizit aufgerufen, wenn eine Konvertierung von einem hierarchyid-Typ in einen Zeichenfolgentyp stattfindet. Fungiert als Gegenstück zu Parse Datenbank-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  ( )

Rückgabetypen

SQL Server-Rückgabetyp: nvarchar(4000)

CLR-Rückgabetyp: String

Bemerkungen

Gibt die logische Position in der Hierarchie zurück. Beispielsweise stellt /2/1/ die vierte Zeile (Microsoft SQL Server) in der folgenden hierarchischen Struktur eines Dateisystems dar:

/        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  

Beispiele

A. Transact-SQL-Beispiel in einer Tabelle

Im folgenden Beispiel wird sowohl die OrgNode-Spalte als auch der hierarchyid-Datentyp in einem leichter lesbaren Format zurückgegeben:

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

Hier sehen Sie das Ergebnis.

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

B. Konvertieren von Transact-SQL-Werten ohne Tabelle

Im folgenden Codebeispiel wird mithilfe von ToString ein hierarchyid-Wert in eine Zeichenfolge und mithilfe von Parse ein Zeichenfolgenwert in eine hierarchyid konvertiert.

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  

Hier sehen Sie das Ergebnis.

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

C. CLR-Beispiel

Im folgenden Codeausschnitt wird die ToString()-Methode aufgerufen:

this.ToString()  

Weitere Informationen

hierarchyid-Datentyp-Methodenverweis
Hierarchische Daten (SQL Server)
hierarchyid (Transact-SQL)