Parse (motor de base de datos)

  • Artículo

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Parse convierte la representación de cadena canónica de hierarchyid en un valor hierarchyid. Se llama implícitamente a Parse cuando se produce una conversión de un tipo de cadena a hierarchyid. Tiene el efecto contrario de ToString. Parse() es un método estático.

Sintaxis

-- Transact-SQL syntax  
hierarchyid::Parse ( input )  
-- This is functionally equivalent to the following syntax   
-- which implicitly calls Parse():  
CAST ( input AS hierarchyid )  

-- CLR syntax  
static SqlHierarchyId Parse ( SqlString input )

Nota:

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

Argumentos

input
Transact-SQL: Valor de tipo de datos de carácter que se va a convertir.

CLR: Valor de cadena que se va a evaluar.

Tipos de valor devuelto

Tipo de valor devuelto de SQL Server: hierarchyid

Tipo devuelto de CLR: SqlHierarchyId

Observaciones

Si Parse recibe un valor que no es una representación de cadena válida de un hierarchyid, se producirá una excepción. Por ejemplo, si los tipos de datos char contienen espacios finales, se producirá una excepción.

Ejemplos

A. 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/

B. Ejemplo de CLR

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

string input = "/1/2/";  
SqlHierarchyId.Parse(input);

Consulte también

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