Partilhar via

Analisar (Mecanismo de Banco de Dados)

  • Artigo

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do Azurebanco de dados SQL no Microsoft Fabric

Parse converte a representação de cadeia de caracteres canônica de um hierarchyid em um valor de hierarchyid . A análise é chamada implicitamente quando ocorre uma conversão de um tipo de cadeia de caracteres para 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

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

CLR: O valor String que está sendo avaliado.

Tipos de devolução

Tipo de retorno do SQL Server:hierarchyid

tipo de retorno CLR:SqlHierarchyId

Comentários

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

Exemplos

Um. Convertendo valores de 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 um 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

Aqui está o conjunto de resultados.

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

B. Exemplo de CLR

O trecho de código a seguir chama o método Parse():

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

Ver também

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