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

Статья
01/02/2025

Область применения: 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 )

Аргументы

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)

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