ToString (Mecanismo de Banco de Dados)
Retorna uma cadeia de caracteres com a representação lógica de this. ToString é chamado implicitamente quando uma conversão de hierarchyid em um tipo de cadeia de caracteres ocorre. 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 Parse para converter o valor da cadeia de caracteres 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()