Parse (Mecanismo de Banco de Dados)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do Azure

O método Parse converte a representação de cadeia de caracteres canônica de uma hierarchyid para um valor hierarchyid. O método Parse é chamado implicitamente quando ocorre uma conversão de um tipo de cadeia de caracteres em hierarchyid. Atua como o oposto de ToString. Parse() é um método estático.

Sintaxe

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

Argumentos

input
Transact-SQL: o valor do tipo de dados de caractere que está sendo convertido.

CLR: o valor String que está sendo avaliado.

Tipos de retorno

Tipo de retorno do SQL Server: hierarchyid

Tipo de retorno do CLR: SqlHierarchyId

Comentários

Se o método Parse receber um valor que não for uma representação de cadeia de caracteres válida de uma hierarchyid, será gerada uma exceção. Por exemplo, se tipos de dados char contiverem espaços à direita, será gerada uma exceção.

Exemplos

a. Convertendo valores Transact-SQL sem uma tabela

O exemplo de código a seguir usa ToString para converter um valor hierarchyid em uma cadeia de caracteres e Parse para converter um valor de cadeia de caracteres em uma 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  

Este é o conjunto de resultados.

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

B. Exemplo de CLR

O seguinte snippet de código chama o método Parse():

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

Confira também

Referência de método de tipo de dados hierarchyid
Dados hierárquicos (SQL Server)
hierarchyid (Transact-SQL)