XmlSiteMapProvider.FindSiteMapNode(String) Metodo

Definizione

Recupera un oggetto SiteMapNode che rappresenta la pagina nell'URL specificato.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

Parametri

rawUrl
String

URL che identifica la pagina per la quale recuperare un elemento SiteMapNode.A URL that identifies the page for which to retrieve a SiteMapNode.

Restituisce

Classe SiteMapNode che rappresenta la pagina identificata da rawURL.A SiteMapNode that represents the page identified by rawURL.

Eccezioni

Il provider figlio collegato al provider della mappa del sito corrente ha restituito un nodo non valido.A child provider linked to the current site map provider returned a node that is not valid.

Commenti

L' XmlSiteMapProvider oggetto esegue l' FindSiteMapNode override del metodo per garantire la ricerca del nodo da parte di tutti i provider figlio collegati se l'implementazione della classe di base non restituisce un nodo per l'URL specificato.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.

Il rawUrl parametro deve essere un percorso virtuale assoluto o un percorso relativo all'applicazione, a seconda di come viene specificato nel file di dati della mappa del sito 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.

La XmlSiteMapProvider classe e le classi che derivano da essa utilizzano l'URL SiteMapNode di un oggetto come chiave nelle varie raccolte gestite dalla classe.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. Pertanto, questi URL devono essere univoci nell'ambito della mappa del sito.Therefore, these URLs must be unique within the scope of the site map. Se l'URL non viene trovato all'interno dei dati di mappa del sito immediato gestiti da XmlSiteMapProvider, viene FindSiteMapNode chiamato su ogni provider figlio collegato tramite l' provider attributo dei nodi della mappa del sito.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.

Il FindSiteMapNode metodo chiama indirettamente il BuildSiteMap metodo per recuperare il nodo di primo livello nella mappa del sito.The FindSiteMapNode method indirectly calls the BuildSiteMap method to retrieve the top-level node in the site map. Pertanto, le eccezioni che si verificano BuildSiteMap per il metodo possono verificarsi anche quando FindSiteMapNode si chiama il metodo.Therefore, any exceptions that occur for the BuildSiteMap method can also occur when calling the FindSiteMapNode method.

Si applica a

Vedi anche