Parse (moteur de base de données)

S’applique à : SQL ServerAzure SQL Database Azure SQL Managed Instance

Parse convertit la représentation de chaîne canonique d’un hierarchyid en valeur hierarchyid. Parse est appelée implicitement quand une conversion d’un type chaîne en hierarchyid se produit. Agit comme l’opposé de ToString. Parse() est une méthode statique.

Syntaxe

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

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

input
Transact-SQL : valeur du type de données caractères convertie.

CLR : valeur de chaîne évaluée.

Types de retour

Type de retour SQL Server : hierarchyid

Type de retour CLR : SqlHierarchyId

Remarques

Si Parse reçoit une valeur qui n’est pas une représentation de chaîne valide d’un hierarchyid, une exception est levée. Par exemple, si les types de données char contiennent des espaces de fin, une exception est levée.

Exemples

R. Conversion de valeurs Transact-SQL sans table

L’exemple de code suivant utilise ToString pour convertir une valeur hierarchyid en une chaîne et Parse pour convertir une valeur de chaîne 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  

Voici le jeu de résultats obtenu.

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

B. Exemple CLR

L’extrait de code suivant appelle la méthode Parse() :

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

Voir aussi

Référence de méthodes de type de données hierarchyid
Données hiérarchiques (SQL Server)
hierarchyid (Transact-SQL)