ToString (Mesin Database)

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Mengembalikan string dengan representasi logis ini. ToString dipanggil secara implisit ketika konversi dari hierarkiid ke jenis string terjadi. Bertindak sebagai kebalikan dari Parse (Mesin Database).

Sintaksis

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

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Jenis yang dikembalikan

Jenis pengembalian SQL Server:nvarchar(4000)

Jenis pengembalian CLR:String

Keterangan

Mengembalikan lokasi logis dalam hierarki. Misalnya, /2/1/ mewakili baris keempat (Microsoft SQL Server) dalam struktur hierarkis sistem file berikut:

/        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  

Contoh

J. Contoh T-SQL dalam tabel

Contoh berikut mengembalikan OrgNode kolom sebagai jenis data hierarkisid dan dalam format string yang lebih dapat dibaca:

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

Berikut adalah hasil yang ditetapkan.

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

B. Mengonversi nilai Transact-SQL tanpa tabel

Contoh kode berikut menggunakan ToString untuk mengonversi nilai hierarkiid menjadi string, dan Parse untuk mengonversi nilai string menjadi hierarkiid.

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  

Berikut adalah hasil yang ditetapkan.

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

C. Contoh CLR

Cuplikan kode berikut memanggil metode ToString():

this.ToString()  

Baca juga

Referensi Metode Tipe Data hierarkiid
Data Hierarkis (SQL Server)
hierarki (Transact-SQL)