Parsa (databasmotor)

Gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-databas i Microsoft Fabric

Parsa konverterar den kanoniska strängrepresentationen av en hierarchyid till ett hierarchyid- värde. Parsning anropas implicit när en konvertering från en strängtyp till hierarchyid inträffar. Fungerar som motsatsen till ToString. Parsa() är en statisk metod.

Syntax

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

Arguments

input
Transact-SQL: Värdet för teckendatatypen som konverteras.

CLR: Strängvärdet som utvärderas.

Returtyper

SQL Server-returtyp:hierarchyid

CLR-returtyp:SqlHierarchyId

Remarks

Om Parsa tar emot ett värde som inte är en giltig strängrepresentation av en hierarchyidutlöses ett undantag. Om till exempel tecken datatyper innehåller avslutande blanksteg utlöses ett undantag.

Examples

A. Konvertera Transact-SQL värden utan en tabell

I följande kodexempel används ToString för att konvertera ett hierarchyid--värde till en sträng och Parse för att konvertera ett strängvärde till ett 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  

Här är resultatuppsättningen.

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

B. CLR-exempel

Följande kodfragment anropar metoden Parse():

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

Se även

hierarchyid-datatypsmetodreferens
(Hierarchical Data)
hierarki (Transact-SQL)