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

Метод Parse преобразует каноническое представление строки hierarchyid в значение hierarchyid. Parse вызывается неявно, когда происходит преобразование из строкового типа в 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 ) 

Аргумент

  • input
    Transact-SQL: преобразуемое значение символьного типа данных.

    CLR: оцениваемое значение типа String.

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

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

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

Замечания

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

Примеры

А. Преобразование значений 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/

Б. Пример CLR

В следующем фрагменте кода вызывается метод Parse():

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