ToString (motor de base de datos)
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 de 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 ( )
Tipos de valores devueltos
Tipo de valor devuelto de SQL Server: nvarchar(4000)
Tipo de valor devuelto de CLR: String
Comentarios
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 ejemplo siguiente 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 un valor 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 fragmento de código siguiente se llama al método ToString():
this.ToString()