ToString (Mecanismo de Banco de Dados)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

Retorna uma cadeia de caracteres com a representação lógica de this. ToString é chamado implicitamente quando ocorre uma conversão de hierarchyid em um tipo de cadeia de caracteres. Atua como o oposto de Analisar (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  ( )

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Tipos de retorno

Tipo de retorno do SQL Server: nvarchar(4000)

Tipo de retorno do 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

O seguinte exemplo retorna a coluna OrgNode como o tipo de dados hierarchyid e no formato de cadeia de caracteres mais legível:

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

Este é 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 Parse para converter um valor de cadeia de caracteres em uma 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  

Este é o conjunto de resultados.

hierarchyidRepresentation    StringRepresentation
-------------------------    -----------------------
0x5ADE                       /1/1/3/

C. Exemplo de CLR

O seguinte snippet de código chama o método ToString():

this.ToString()  

Confira também

Referência de método de tipo de dados hierarchyid
Dados hierárquicos (SQL Server)
hierarchyid (Transact-SQL)