ToString (motor de base de datos)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Devuelve una cadena con la representación lógica de this. Se llama implícitamente a ToString cuando se produce una conversión de hierarchyid en un tipo de cadena. Tiene el efecto contrario a Parse (Motor de base de datos).

Sintaxis

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

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Tipos de valores devueltos

Tipo de valor devuelto de SQL Server: nvarchar(4000)

Tipo de valor devuelto de CLR: String

Observaciones

Devuelve la ubicación lógica en la jerarquía. Por ejemplo, /2/1/ representa la cuarta fila (Microsoft SQL Server) de la siguiente estructura jerárquica de un sistema de archivos:

/        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

Ejemplos

A. Ejemplo de Transact-SQL en una tabla

En el siguiente ejemplo se devuelve la columna OrgNode como tipo de datos hierarchyid y en el formato de cadena, que es más legible:

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

El conjunto de resultados es el siguiente:

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

B. Convertir valores de Transact-SQL sin una tabla

En el siguiente ejemplo de código se usa ToString para convertir un valor hierarchyid en una cadena, y Parse para convertir un valor de cadena en 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

El conjunto de resultados es el siguiente:

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

C. Ejemplo de CLR

En el siguiente fragmento de código se llama al método ToString():

this.ToString()

Consulte también

Referencia de los métodos del tipo de datos hierarchyid
Datos jerárquicos (SQL Server)
hierarchyid (Transact-SQL)