Parse (компонент Database Engine)

Применимо к:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureБаза данных SQL в Microsoft Fabric

Метод Parse преобразует каноническое представление строки hierarchyid в значение hierarchyid. Метод Parse вызывается неявно при преобразовании из строкового типа в hierarchyid. Действие противоположно 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: оцениваемое значение типа String.

Типы возвращаемых данных

Возвращаемый тип SQL Server:hierarchyid

Возвращаемый тип CLR:SqlHierarchyId

Remarks

Если метод Parse получает значение, которое не является допустимым строковым представлением hierarchyid, возникает исключение. Например, если типы данных char содержат конечные пробелы, возникает исключение.

Examples

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)