SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サイト マップ プロバイダーがオーバーライドして、指定した SiteMapNode オブジェクトの相対として 1 つ以上のレベルの親ノードと先祖ノードの最適化された取得を実行できるメソッドを提供します。
public:
virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);public virtual void HintAncestorNodes (System.Web.SiteMapNode node, int upLevel);abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unitPublic Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)パラメーター
- node
- SiteMapNode
upLevel の参照ポイントとして動作する SiteMapNode。
- upLevel
- Int32
フェッチする先祖 SiteMapNode 世代の数。 0 は、先祖ノードが取得されないことを示します。-1 は、すべての先祖が取得され、キャッシュされることを示します。
例外
upLevel が -1 未満です。
node が nullです。
注釈
既定HintAncestorNodesのメソッドでは、-1 未満のupLevelパラメーターとnode``nullパラメーターがチェックされます。 クラスは XmlSiteMapProvider サイト マップ情報をメモリにキャッシュするため、 HintAncestorNodes メソッドは使用されません。
サイト マップ プロバイダーは、メソッドを HintAncestorNodes オーバーライドして、指定した SiteMapNode オブジェクトの親ノードと先祖ノードの最適化された取得を実行できます。
この upLevel パラメーターは、指定したノードから走査する親ノードと先祖ノードのレベルの数を指定するために使用されます SiteMapNode。 要求されたレベルより少ないレベルが存在する場合、使用可能なすべての先祖ノードが指定されたバインド内で返されます。 必要に応じて、プロパティを使用して、親ノードを指定した SiteMapNode ノードに ParentNode リンクできます。