GetLevel (Datenbankmodul)

Gibt eine ganze Zahl zurück, die die Tiefe des Knotens this in der Struktur darstellt.

Syntax

-- Transact-SQL syntax
node.GetLevel ( ) 

-- CLR syntax
SqlInt16 GetLevel ( ) 

Rückgabetypen

**SQL Server-Rückgabetyp:**smallint

**CLR-Rückgabetyp:**SqlInt16

Hinweise

Wird zur Bestimmung der Ebene eines oder mehrerer Knoten oder zur Filterung der Knoten nach Elementen einer bestimmten Ebene verwendet. Der Stamm der Hierarchie ist Ebene 0.

GetLevel ist sehr nützlich für Breitensuchindizes. Weitere Informationen finden Sie unter Verwenden von hierarchyid-Datentypen (Datenbankmodul).

Beispiele:

A. Zurückgeben der Hierarchieebene als Spalte

Im folgenden Beispiel wird eine Textdarstellung von hierarchyid und anschließend die Hierarchieebene als EmpLevel-Spalte für alle Zeilen in der Tabelle zurückgegeben:

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

B. Zurückgeben aller Elemente einer Hierarchieebene

Im folgenden Beispiel werden alle Zeilen in der Tabelle auf Hierarchieebene 2 zurückgegeben:

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

C. Zurückgeben des Stamms der Hierarchie

Im folgenden Beispiel wird der Stamm der Hierarchieebene zurückgegeben.

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

D. CLR-Beispiel

Im folgenden Codeausschnitt wird die GetLevel()-Methode aufgerufen.

this.GetLevel()