ToString (Mecanismo de Banco de Dados)

Retorna uma cadeia de caracteres com representação lógica de this. ToString é chamado implicitamente quando ocorre uma conversão de hierarchyid em um tipo de cadeia de caracteres. Age como o oposto do Parse (Mecanismo de Banco de Dados).

Sintaxe

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

Tipos de retorno

Tipo de retorno do SQL Server: nvarchar(4000)

Tipo de retorno CLR: String

Comentários

Retorna o local lógico na hierarquia. Por exemplo, /2/1/ representa a quarta linha (Microsoft SQL Server) na seguinte estrutura hierárquica de um sistema de arquivos:

/        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

Exemplos

A.Exemplo de Transact-SQL em uma tabela

Este exemplo retorna a coluna OrgNode tanto como o tipo de dados hierarchyid quanto no formato de cadeia de caracteres mais legível:

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

Aqui está o conjunto de resultados.

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

B.Convertendo valores Transact-SQL sem uma tabela

O exemplo de código a seguir usa ToString para converter um valor hierarchyid em uma cadeia de caracteres e para converter o valor da cadeia de caracteres Parse em 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

Aqui está o conjunto de resultados.

hierarchyidRepresentation StringRepresentation

------------------------- -----------------------

0x5ADE /1/1/3/

C.Exemplo de CLR

O trecho de código a seguir chama o método ToString():

this.ToString()

Consulte também

Referência

hierarchyid (Transact-SQL)

Conceitos

Referência de método de tipo de dados hierarchyid

Dados hierárquicos (SQL Server)