GetLevel (Mecanismo de Banco de Dados)

Retorna um inteiro que representa a profundidade do nó this na árvore.

Sintaxe

-- Transact-SQL syntax
node.GetLevel ( ) 

-- CLR syntax
SqlInt16 GetLevel ( ) 

Tipos de retorno

**Tipo de retorno do SQL Server:**smallint

**Tipo de retorno CLR:**SqlInt16

Comentários

Usado para determinar o nível de um ou mais nós ou para filtrar os nós de membros de um nível especificado. A raiz da hierarquia é nível 0.

GetLevel é muito útil para índices de busca primeiro em largura. Para obter mais informações, consulte Usando tipos de dados hierarchyid (Mecanismo de Banco de Dados).

Exemplos

A. Retornando o nível de hierarquia como uma coluna

O exemplo a seguir retorna uma representação de texto de hierarchyid e, depois, o nível de hierarquia como a coluna EmpLevel para todas as linhas na tabela:

SELECT OrgNode.ToString() AS Text_OrgNode, 
OrgNode.GetLevel() AS EmpLevel, *
FROM HumanResources.EmployeeDemo

B. Retornando todos os membros de um nível de hierarquia

O seguinte exemplo retorna todas as linhas na tabela no nível de hierarquia 2:

SELECT OrgNode.ToString() AS Text_OrgNode, 
OrgNode.GetLevel() AS EmpLevel, *
FROM HumanResources.EmployeeDemo
WHERE OrgNode.GetLevel() = 2

C. Retornando a raiz da hierarquia

O seguinte exemplo retorna a raiz da árvore do nível de hierarquia:

SELECT OrgNode.ToString() AS Text_OrgNode, 
OrgNode.GetLevel() AS EmpLevel, *
FROM HumanResources.EmployeeDemo
WHERE OrgNode.GetLevel() = 0

D. Exemplo de CLR

O seguinte trecho de código chama o método GetLevel():

this.GetLevel()