Partilhar via

ToString (Mecanismo de Banco de Dados)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do Azurebanco de dados SQL no Microsoft Fabric

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

SQL Server tipo de retorno: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

Um. Transact-SQL exemplo numa tabela

O exemplo a seguir retorna a coluna OrgNode como o hierarchyid tipo de dados e 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 de 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 um 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()

Ver também

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