剖析 (Database Engine)

適用於：SQL ServerAzure SQL 資料庫 Azure SQL 受控執行個體

Parse 會將 hierarchyid 的標準字串表示法轉換成 hierarchyid 值。 將字串類型轉換成 hierarchyid 時，就會隱含呼叫 Parse。 其作用與 ToString 相反。 Parse() 是一種靜態方法。

Syntax

-- Transact-SQL syntax  
hierarchyid::Parse ( input )  
-- This is functionally equivalent to the following syntax   
-- which implicitly calls Parse():  
CAST ( input AS hierarchyid )  

-- CLR syntax  
static SqlHierarchyId Parse ( SqlString input )   

注意

若要檢視 SQL Server 2014 (12.x) 和更早版本的 Transact-SQL 語法，請參閱舊版文件。

引數

input
Transact-SQL：正在轉換的字元資料類型值。

CLR：正在評估的字串值。

傳回型別

SQL Server 傳回型別：hierarchyid

CLR 傳回型別：SqlHierarchyId

備註

若 Parse 收到一個值，而這個值不是 hierarchyid 的有效字串表示法，則會引發例外狀況。 例如，若 char 資料類型包含尾端空白，則會引發例外狀況。

範例

A. 轉換 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/

B. CLR 範例

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

string input = "/1/2/";  
SqlHierarchyId.Parse(input);  

另請參閱

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