XmlSiteMapProvider.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.
Eccezioni
Il provider figlio collegato al provider della mappa del sito corrente ha restituito un nodo non valido.
Commenti
L'oggetto XmlSiteMapProvider esegue l'override del FindSiteMapNode metodo per assicurarsi che tutti i provider figlio collegati vengano cercati per il nodo se l'implementazione della classe di base non restituisce un nodo per l'URL specificato.
Il rawUrl parametro deve essere un percorso virtuale assoluto o un percorso relativo all'applicazione, a seconda del modo in cui viene specificato nel file di dati della mappa del sito XML.
La XmlSiteMapProvider classe e le classi derivate da esso usano l'URL di un SiteMapNode oggetto come chiave nelle varie raccolte che la classe gestisce. Pertanto, questi URL devono essere univoci nell'ambito della mappa del sito. Se l'URL non viene trovato all'interno dei dati della mappa del sito immediata gestiti da XmlSiteMapProvider, chiama l'oggetto in ogni provider figlio collegato tramite l'attributo FindSiteMapNodeprovider dei nodi della mappa del sito.
Il FindSiteMapNode metodo chiama indirettamente il metodo per recuperare il BuildSiteMap nodo di primo livello nella mappa del sito. Pertanto, tutte le eccezioni che si verificano per il BuildSiteMap metodo possono verificarsi anche quando si chiama il FindSiteMapNode metodo.
