ToString (Datenbankmodul)
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. Dient als Gegenstück zu Parse (Datenbankmodul).
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
Hinweise
Gibt die logische Position in der Hierarchie zurück. Beispielsweise stellt /2/1/ die vierte Zeile (MicrosoftSQL 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
Dies ist das Resultset.
OrgNode Node
0x /
0x58 /1/
0x5AC0 /1/1/
0x5B40 /1/2/
0x5BC0 /1/3/
0x5C20 /1/4/
...
B. Konvertieren von Transact-SQL-Werten ohne eine 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
Dies ist das Resultset.
hierarchyidRepresentation StringRepresentation
------------------------- -----------------------
0x5ADE /1/1/3/
C. CLR-Beispiel
Im folgenden Codeausschnitt wird die ToString()-Methode aufgerufen.
this.ToString()