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

rawURL で示されるページを表す SiteMapNode。

例外

ProviderException

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

注釈

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

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

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

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

適用対象

こちらもご覧ください