Parse (Mecanismo de Banco de Dados)
Parse converte a representação de cadeia de caracteres canônica de um nó hierarchyid em um valor hierarchyid. 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 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
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);