XmlSiteMapProvider.FindSiteMapNode(String) Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

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.SiteMapNode

Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

Parametri

rawUrl

String

URL che identifica la pagina per la quale recuperare un elemento SiteMapNode.

Restituisce

SiteMapNode

Classe SiteMapNode che rappresenta la pagina identificata da rawURL.

Eccezioni

ProviderException

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.

Vedi anche

• GetRootNodeCore()
• BuildSiteMap()