XmlSiteMapProvider.FindSiteMapNode(String) メソッド

定義

指定した URL のページを表す SiteMapNode オブジェクトを取得します。Retrieves a SiteMapNode object that represents the page at the specified URL.

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。A URL that identifies the page for which to retrieve a SiteMapNode.

戻り値

SiteMapNode で示されるページを表す rawURLA SiteMapNode that represents the page identified by rawURL.

例外

現在のサイト マップ プロバイダーにリンクされている子プロバイダーが、有効でないノードを返しました。A child provider linked to the current site map provider returned a node that is not valid.

注釈

XmlSiteMapProvider オブジェクトは、FindSiteMapNode メソッドをオーバーライドして、基底クラスの実装が指定された URL のノードを返さない場合に、リンクされた子プロバイダーが確実にそのノードを検索するようにします。The XmlSiteMapProvider object overrides the FindSiteMapNode method to ensure that any linked child providers are searched for the node if the implementation of the base class does not return a node for the specified URL.

rawUrl パラメーターは、XML サイトマップのデータファイルに指定されている方法に応じて、絶対仮想パスまたはアプリケーション相対パスのいずれかである必要があります。The rawUrl parameter should be either an absolute virtual path or an application-relative path, depending on how it is specified in the XML site map data file.

XmlSiteMapProvider クラスとその派生クラスは、クラスが保持するさまざまなコレクションのキーとして、SiteMapNode オブジェクトの URL を使用します。The XmlSiteMapProvider class and classes that are derived from it use the URL of a SiteMapNode object as a key in the various collections that the class maintains. そのため、これらの Url はサイトマップのスコープ内で一意である必要があります。Therefore, these URLs must be unique within the scope of the site map. XmlSiteMapProviderによって管理される直下のサイトマップデータ内に URL が見つからない場合は、そのサイトマップノードの provider 属性を介してリンクされている各子プロバイダーで FindSiteMapNode が呼び出されます。If the URL is not found within the immediate site map data that is managed by the XmlSiteMapProvider, it calls the FindSiteMapNode on each child provider that is linked to it through the provider attribute of its site map nodes.

FindSiteMapNode メソッドは、BuildSiteMap メソッドを間接的に呼び出して、サイトマップ内の最上位ノードを取得します。The FindSiteMapNode method indirectly calls the BuildSiteMap method to retrieve the top-level node in the site map. したがって、BuildSiteMap メソッドで発生した例外は、FindSiteMapNode メソッドの呼び出し時にも発生する可能性があります。Therefore, any exceptions that occur for the BuildSiteMap method can also occur when calling the FindSiteMapNode method.

適用対象

こちらもご覧ください