Parse (Mecanismo de Banco de Dados)
A análise converte a representação da cadeia de caracteres canônica de uma hierarchyid em um valor hierarchyid. Parse é chamado implicitamente quando ocorre a conversão de um tipo de cadeia de caracteres em hierarchyid. Age como o oposto do 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 CLR:**SqlHierarchyId
Comentários
Se 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 para converter o valor da cadeia de caracteres Parse em 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
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);