XmlSiteMapProvider.FindSiteMapNode(String) メソッド

定義

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

指定した URL のページを表す SiteMapNode オブジェクトを取得します。

public:
 override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);
public override System.Web.SiteMapNode FindSiteMapNode(string rawUrl);
override this.FindSiteMapNode : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

パラメーター

rawUrl
String

SiteMapNodeを取得するページを識別する URL。

返品

SiteMapNode

SiteMapNodeによって識別されるページを表すrawURL。

例外

ProviderException

現在のサイト マップ プロバイダーにリンクされている子プロバイダーから、無効なノードが返されました。

注釈

XmlSiteMapProvider オブジェクトは、基底クラスの実装が指定された URL のノードを返さない場合に、リンクされた子プロバイダーがノードを検索するように、FindSiteMapNode メソッドをオーバーライドします。

rawUrl パラメーターは、XML サイト マップ データ ファイルでの指定方法に応じて、絶対仮想パスまたはアプリケーション相対パスのいずれかである必要があります。

XmlSiteMapProviderクラスと、そこから派生したクラスは、SiteMapNode オブジェクトの URL を、クラスが保持するさまざまなコレクションのキーとして使用します。 そのため、これらの URL はサイト マップのスコープ内で一意である必要があります。 XmlSiteMapProviderによって管理されている即時サイト マップ データ内に URL が見つからない場合は、サイト マップ ノードのFindSiteMapNode属性を使用して、リンクされている各子プロバイダーのproviderを呼び出します。

FindSiteMapNode メソッドは、BuildSiteMap メソッドを間接的に呼び出して、サイト マップ内の最上位ノードを取得します。 そのため、 BuildSiteMap メソッドに対して発生する例外は、 FindSiteMapNode メソッドを呼び出すときにも発生する可能性があります。

適用対象

こちらもご覧ください