SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在要求されているページの先祖ノードを取得し、その先祖の子孫ノードをフェッチする際、サイト マップ プロバイダーに最適化された検索メソッドを提供します。
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.SiteMapNodePublic Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeパラメーター
- walkupLevels
- Int32
要求された先祖ノードを取得する際に走査する先祖ノードのレベル数。
- relativeDepthFromWalkup
- Int32
目的の先祖ノードから取得する子孫ノードのレベル数。
戻り値
現在要求されているページの先祖 SiteMapNode を表す SiteMapNode。現在または先祖の SiteMapNode が見つからなかった場合、または見つかったが現在のユーザーに返すことができない場合は null。
例外
walkupLevels または relativeDepthFromWalkup が 0 未満です。
注釈
クラスの既定のSiteMapProvider実装では、メソッドのGetParentNodeRelativeToCurrentNodeAndHintDownFromParent非最適化実装が提供され、メソッドがHintNeighborhoodNodes呼び出GetCurrentNodeAndHintAncestorNodesされます。ただし、サイト マップ プロバイダーはメソッドをGetParentNodeRelativeToCurrentNodeAndHintDownFromParentオーバーライドし、カスタム キャッシュ メカニズムを使用して先祖ノードを返し、他SiteMapNodeのオブジェクトの最適化された検索を実行する最適化された実装を提供できます。
この walkupLevels パラメーターは、ターゲット ノードを取得するときに走査する親ノードと先祖ノードのレベルの数を指定するために使用されます。 要求されたレベルより少ないレベルが存在する場合は、 null 返されます。 この downLevel パラメーターは、取得するターゲット先祖ノードの子孫ノードのレベル数を指定するために使用されます。 必要に応じて、先祖ノードと子孫ノードを、メソッドによってGetParentNodeRelativeToCurrentNodeAndHintDownFromParent返されるノードにリンクSiteMapNodeし、プロパティChildNodesをParentNode使用できます。