Parseren (database-engine)

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceSQL-database in Microsoft Fabric Preview

Parseren converteert de canonieke tekenreeksweergave van een hierarchyid naar een hiërarchie-id waarde. Parseren wordt impliciet aangeroepen wanneer een conversie van een tekenreekstype naar hiërarchie-id plaatsvindt. Fungeert als het tegenovergestelde van ToString. Parse() is een statische methode.

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: de waarde van het gegevenstype teken die wordt geconverteerd.

CLR: De tekenreekswaarde die wordt geëvalueerd.

Return Types

sql Server-retourtype: hierarchyid-

CLR-retourtype: SqlHierarchyId

Remarks

Als Parse een waarde ontvangt die geen geldige tekenreeksweergave is van een hiërarchie-id, wordt er een uitzondering gegenereerd. Als teken bijvoorbeeld gegevenstypen volgspaties bevatten, wordt er een uitzondering gegenereerd.

Examples

A. Transact-SQL waarden zonder tabel converteren

In het volgende codevoorbeeld wordt ToString gebruikt om een hiërarchie-id waarde te converteren naar een tekenreeks en Parse om een tekenreekswaarde te converteren naar een hiërarchie-id.

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  

Dit is de resultatenset.

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

B. CLR example

Met het volgende codefragment wordt de methode Parse() aangeroepen:

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

See also

gegevenstype van de hiërarchie-id
Hierarchical Data (SQL Server)
hierarchyid (Transact-SQL)