Share via

  • [アーティクル]

IsDescendantOf (データベース エンジン)

this が parent の子孫である場合に true を返します。

構文

-- Transact-SQL syntax
child.IsDescendantOf ( parent )

-- CLR syntax
SqlHierarchyId IsDescendantOf (SqlHierarchyId parent )

引数

  • parent
    IsDescendantOf テストの実行対象となる hierarchyid ノード。

戻り値の型

**SQL Server の戻り値の型 :**bit

**CLR の戻り値の型 :**SqlBoolean

説明

親をルートとするサブツリー内のすべてのノードには true、それ以外のノードには false を返します。

親はそれ自身の子孫と見なされます。

例

A. WHERE 句で IsDescendantOf を使用する

次の例では、指定したマネージャー、およびそのマネージャーの部下にあたる従業員を取得します。

DECLARE @Manager hierarchyid
SELECT @Manager = OrgNode FROM HumanResources.EmployeeDemo
  WHERE LoginID = 'adventure-works\dylan0'

SELECT * FROM HumanResources.EmployeeDemo
WHERE OrgNode.IsDescendantOf(@Manager) = 1

B. IsDescendantOf を使用してリレーションシップを評価する

次のコードでは、3 つの変数を宣言して設定します。その後に階層リレーションシップを評価し、比較を基に 2 つの出力結果のいずれかを返します。

DECLARE @Manager hierarchyid, @Employee hierarchyid, @LoginID nvarchar(256)
SELECT @Manager = OrgNode FROM HumanResources.EmployeeDemo
WHERE LoginID = 'adventure-works\terri0' ;

SELECT @Employee = OrgNode, @LoginID = LoginID FROM HumanResources.EmployeeDemo
  WHERE LoginID = 'adventure-works\rob0'

IF @Employee.IsDescendantOf(@Manager) = 1
   BEGIN
    PRINT 'LoginID ' + @LoginID + ' is a subordinate of the selected Manager.'
   END
ELSE
   BEGIN
    PRINT 'LoginID ' + @LoginID + ' is not a subordinate of the selected Manager.' ;
   END

C. 共通言語ランタイム メソッドを呼び出す

次のコード例では IsDescendantOf() メソッドを呼び出します。

this.IsDescendantOf(Parent)