XmlSiteMapProvider.FindSiteMapNode(String) XmlSiteMapProvider.FindSiteMapNode(String) XmlSiteMapProvider.FindSiteMapNode(String) XmlSiteMapProvider.FindSiteMapNode(String) Method

定義

指定した 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 String String String

SiteMapNode を取得するページを示す URL。A URL that identifies the page for which to retrieve a SiteMapNode.

戻り値

rawURL で示されるページを表す SiteMapNodeA 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 が見つからない場合は、サイトFindSiteMapNodeマップノードのprovider属性を通じて、リンクされている各子プロバイダーのを呼び出します。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.

適用対象

こちらもご覧ください