SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent メソッド

定義

名前空間:
System.Web
アセンブリ:
System.Web.dll

現在要求されているページの先祖ノードを取得し、先祖の子孫ノードをフェッチするときに、サイト マップ プロバイダー用に最適化された検索方法を提供します。

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

パラメーター

walkupLevels
Int32

要求された先祖ノードを取得するときに走査する先祖ノード レベルの数。

relativeDepthFromWalkup
Int32

ターゲットの先祖ノードから取得する子孫ノード レベルの数。

返品

SiteMapNode

現在要求されているページの先祖SiteMapNodeを表すSiteMapNode。それ以外の場合は、現在または先祖のnullが見つからないか、現在のユーザーに対して返すことができない場合はSiteMapNode。

例外

ArgumentOutOfRangeException

walkupLevels または relativeDepthFromWalkup が 0 未満です。

注釈

SiteMapProvider クラスの既定の実装では、GetParentNodeRelativeToCurrentNodeAndHintDownFromParent メソッドの最適化されていない実装が提供され、GetCurrentNodeAndHintAncestorNodesメソッドとHintNeighborhoodNodes メソッドが呼び出されます。ただし、サイト マップ プロバイダーは、GetParentNodeRelativeToCurrentNodeAndHintDownFromParent メソッドをオーバーライドし、カスタム キャッシュ メカニズムを使用して先祖ノードを返し、他のSiteMapNode オブジェクトの最適化された検索を実行する最適化された実装を提供できます。

walkupLevels パラメーターは、ターゲット ノードを取得するときに走査する親ノードと先祖ノードのレベルの数を指定するために使用されます。 要求されたレベルよりも少ないレベルが存在する場合は、 null が返されます。 downLevel パラメーターは、取得するターゲット先祖ノードの子孫ノードのレベル数を指定するために使用されます。 必要に応じて、SiteMapNodeプロパティとGetParentNodeRelativeToCurrentNodeAndHintDownFromParentプロパティを使用して、ParentNode メソッドによって返されるChildNodesに先祖ノードと子孫ノードをリンクできます。

適用対象

こちらもご覧ください