Поделиться через


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

См. также

Справочник

hierarchyid (Transact-SQL)

Основные понятия

Справочник по методам типа данных hierarchyid

Иерархические данные (SQL Server)