Parse (データベース エンジン)

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

正規文字列形式に変換する hierarchyid を hierarchyid 値。 解析 から文字列型を変換するとき暗黙的に呼び出されます hierarchyid が発生します。 逆の役割を果たします ToStringです。 Parse() 静的メソッドです。

構文

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

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

input
Transact-SQL: 変換対象となる文字データ型の値。

CLR : 評価される String 値。

戻り値の型

SQL Server の戻り値の型: hierarchyid

CLR 戻り値の型:SqlHierarchyId

解説

場合 解析 の有効な文字列表記ではない値を受け取る、 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)