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


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

Возвращает строку с логическим представлением объекта this. Метод ToString вызывается неявно, если происходит преобразование типа hierarchyid в строковый тип. Действие обратно вызову метода Parse (компонент Database Engine).

Синтаксис

-- Transact-SQL syntax
node.ToString  ( ) 
-- This is functionally equivalent to the following syntax
-- which implicitly calls ToString():
CAST(node AS nvarchar(4000))

-- CLR syntax
string ToString  ( ) 

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

**Возвращаемый тип SQL Server:**nvarchar(4000)

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

Замечания

Возвращает логическое место в иерархии. Например, /2/1/ представляет четвертую строку (Microsoft SQL Server) в следующей иерархической структуре файловой системы.

/        C:\
/1/      C:\Database Files
/2/      C:\Program Files
/2/1/    C:\Program Files\Microsoft SQL Server
/2/2/    C:\Program Files\Microsoft Visual Studio
/3/      C:\Windows

Примеры

А. Пример использования Transact-SQL в таблице

В следующем примере столбец OrgNode возвращается и как тип данных hierarchyid, и в более удобном для чтения строковом формате.

SELECT OrgNode,
OrgNode.ToString() AS Node
FROM HumanResources.EmployeeDemo
ORDER BY OrgNode ;
GO

Ниже приводится результирующий набор.

OrgNode   Node
0x        /
0x58      /1/
0x5AC0    /1/1/
0x5B40    /1/2/
0x5BC0    /1/3/
0x5C20    /1/4/
...

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

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

this.ToString()