StaticSiteMapProvider.FindSiteMapNode(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Recupera un oggetto SiteMapNode che rappresenta la pagina nell'URL specificato.
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 SiteMapNodeParametri
- rawUrl
- String
URL che identifica la pagina per la quale recuperare un elemento SiteMapNode.
Restituisce
Classe SiteMapNode che rappresenta la pagina identificata da rawURL; in caso contrario, null, se non viene trovato alcun nodo della mappa del sito corrispondente.
Eccezioni
rawURL è null.
Commenti
L'URL fornito è in genere un URL virtuale o assoluto. Può anche essere un URL che usa ASP.NET sintassi relativa all'applicazione, ad esempio "~/apprelativedirectory". La StaticSiteMapProvider classe normalizza automaticamente gli URL non elaborati relativi all'applicazione in un percorso virtuale assoluto.
L'oggettoXmlSiteMapProvider, derivato dall'oggetto StaticSiteMapProvider ed è il provider predefinito della mappa del sito per ASP.NET, usa la Url proprietà di un SiteMapNode oggetto come chiave di ricerca nelle raccolte interne, per impostazione predefinita. Se la Url proprietà dell'oggetto SiteMapNode è impostata, deve essere univoca nell'ambito del provider di mappe del sito. Il FindSiteMapNode metodo tenta di recuperare i nodi della mappa del sito in base al relativo Url. In caso contrario, è possibile usare la proprietà e il Key metodo corrispondente FindSiteMapNodeFromKey per recuperare i nodi della mappa del sito. Se non Url è specificato alcun valore o Key , il provider di mappe del sito genera automaticamente una Key proprietà per tenere traccia dei nodi della mappa del sito.
Note per gli eredi
Quando si esegue l'override del FindSiteMapNode(String) metodo in una classe derivata, assicurarsi di normalizzare gli URL degli SiteMapNode oggetti aggiunti al provider di mappe del sito, in modo che il FindSiteMapNode(String) metodo possa recuperare un nodo della mappa del sito indipendentemente dal fatto che l'URL per il nodo della mappa del sito venga fornito come percorso virtuale assoluto o un percorso relativo dell'applicazione.
Il comportamento di ritaglio della sicurezza è incluso nelle implementazioni e StaticSiteMapProvider della SiteMapProvider classe. Tuttavia, per il ridimensionamento della sicurezza in classi derivate, è necessario impostare la proprietà di tutti gli SiteMapNode oggetti creati durante la creazione di un provider di mappe del sito quando si esegue l'override Roles del BuildSiteMap() metodo.