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

  • Статья

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure

Возвращает строку с логическим представлением this. Метод ToString вызывается неявно при преобразовании из типа hierarchyid в строковый тип. Он действует противоположно методу Parse (ядро СУБД).

Синтаксис

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

Примечание.

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

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

Возвращаемый тип 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/  
...

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

C. Пример CLR

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

this.ToString()

См. также

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