Parse (Motore di database)

Si applica a:SQL ServerDatabase SQL di AzureIstanza gestita di SQL di AzureDatabase SQL in Microsoft Fabric

Il metodo Parse esegue la conversione della rappresentazione stringa canonica di un valore hierarchyid in un valore hierarchyid. Parse viene chiamato in modo implicito quando viene eseguita una conversione da un tipo stringa in hierarchyid. Il metodo funziona in modo opposto a ToString. Parse() è un metodo statico.

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: valore del tipo di dati character convertito.

CLR: valore stringa valutato.

Tipi restituiti

Tipo SQL Server restituito: hierarchyid

Tipo CLR restituito: SqlHierarchyId

Remarks

Se Parse riceve un valore che non è una rappresentazione stringa valida di un valore hierarchyid, viene generata un'eccezione. Se, ad esempio, i tipi di dati char contengono spazi finali, viene generata un'eccezione.

Examples

A. Conversione di valori Transact-SQL senza una tabella

Nell'esempio di codice seguente viene usato ToString per convertire un valore hierarchyid in una stringa e Parse per convertire un valore stringa in un valore 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  

Il set di risultati è il seguente.

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

B. Esempio CLR

Nel frammento di codice seguente viene chiamato il metodo Parse():

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

Vedere anche

Guida di riferimento ai metodi per il tipo di dati hierarchyid
Dati gerarchici (SQL Server)
hierarchyid (Transact-SQL)