StaticSiteMapProvider.FindSiteMapNode(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した 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.SiteMapNodePublic Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNodeパラメーター
- rawUrl
- String
SiteMapNode を取得するページを示す URL。
戻り値
rawURL で示されるページを表す SiteMapNode。対応するサイト マップ ノードが見つからない場合は null。
例外
rawURL が nullです。
注釈
指定された URL は、通常、仮想 URL または絶対 URL です。 また、アプリケーション ASP.NET 相対構文を使用する URL を指定することもできます。例:"~/apprelativedirectory" このクラスは StaticSiteMapProvider 、アプリケーション相対生 URL を絶対仮想パスに自動的に正規化します。
このオブジェクトはXmlSiteMapProvider、ASP.NET の既定のStaticSiteMapProviderサイト マップ プロバイダーから派生し、既定で内部コレクションの参照キーとしてオブジェクトのSiteMapNodeプロパティを使用Urlします。 プロパティが Url 設定されている SiteMapNode 場合は、サイト マップ プロバイダーのスコープ内で一意である必要があります。 このメソッドは FindSiteMapNode 、サイト マップ ノードの取得を、その Urlノードに基づいて試行します。 それ以外の場合は、プロパティと対応するFindSiteMapNodeFromKeyメソッドを使用Keyしてサイト マップ ノードを取得できます。 指定されていない場合、またはKey指定されていないUrl場合、サイト マップ プロバイダーは、サイト マップ ノードをKey追跡するプロパティを自動的に生成します。
注意 (継承者)
派生クラスでメソッドをオーバーライドする FindSiteMapNode(String) 場合は、サイト マップ プロバイダーに追加するオブジェクトの URL を正規化して、サイト マップ ノードの SiteMapNode URL が絶対仮想パスまたはアプリケーション相対パスとして指定されているかどうかに関係なく、サイト マップ ノードを取得できるようにします FindSiteMapNode(String) 。
セキュリティ トリミングの動作は、実装とStaticSiteMapProviderクラスのSiteMapProvider実装に含まれています。 ただし、派生クラスで機能するようにセキュリティ トリミングを行うには、メソッドを Roles オーバーライドするときにサイト マップ プロバイダーの構築中に作成するすべての SiteMapNode オブジェクトのプロパティを設定する BuildSiteMap() 必要があります。