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

Область применения: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

Метод 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 )   

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

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/

B. Пример CLR

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

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

См. также

Справочник по методам типа данных hierarchyid
Иерархические данные (SQL Server)
hierarchyid (Transact-SQL)