ToString (Database Engine)

發行項
01/15/2025

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控實例Microsoft Fabric 中的 SQL 受控實例SQL Database

傳回具有 this 邏輯表示法的字串。當從 hierarchyid 轉換成字串類型時，即會隱含地呼叫 ToString。其作用與剖析 (資料庫引擎) 相反。

語法

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

傳回類型

SQL Server 傳回型別：nvarchar(4000)

CLR 傳回型別：String

備註

傳回階層中的邏輯位置。例如，/2/1/ 代表下列檔案系統階層式結構中的第四個資料列 (Microsoft SQL Server)：

/        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

範例

A. 資料表中的 Transact-SQL 範例

下列範例會以可讀性較佳的字串格式傳回 OrgNode 資料行和 hierarchyid 資料類型：

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

結果集如下所示。

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

B. 轉換 Transact-SQL 值而不使用資料表

下列程式碼範例會使用 ToString 將 hierarchyid 值轉換成字串，並使用 Parse 將字串值轉換成 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

結果集如下所示。

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

C. CLR 範例

下列程式碼片段會呼叫 ToString() 方法：

this.ToString()

另請參閱

Hierarchyid 資料類型方法參考
 階層式資料 (SQL Server)
hierarchyid (Transact-SQL)

共用方式為