共用方式為


剖析 (Database Engine)

適用於:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric 中的 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 )   

Arguments

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

CLR:正在評估的字串值。

傳回型別

SQL Server 傳回型別:hierarchyid

CLR 傳回型別:SqlHierarchyId

Remarks

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

Examples

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

下列程式碼範例會使用 ToStringhierarchyid 值轉換成字串,並使用 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)
階層(Transact-SQL)