XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Metodo

Definizione

Spazio dei nomi:

System.Web

Assembly:

System.Web.dll

Recupera un oggetto SiteMapNode a partire da una chiave specificata.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);

public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);

override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode

Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parametri

key

String

Una chiave di ricerca da utilizzare per individuare la classe SiteMapNode.

Restituisce

SiteMapNode

Classe SiteMapNode che rappresenta la pagina identificata da key. In caso contrario, null, se è attivata la rimozione di sicurezza e il nodo non può essere mostrato all'utente corrente oppure il nodo non viene trovato da key nell'insieme dei nodi.

Eccezioni

ProviderException

Il provider figlio collegato al provider della mappa del sito corrente ha restituito un nodo non valido.

Commenti

La XmlSiteMapProvider classe esegue l'override del FindSiteMapNodeFromKey metodo per assicurarsi che tutti i provider figlio collegati vengano cercati per il nodo, se l'implementazione della classe base non restituisce un nodo per key.

L'oggetto XmlSiteMapProviderStaticSiteMapProvider , derivato dalla classe e dal provider di mapping del sito predefinito 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. Se non Url viene specificato alcun oggetto, viene XmlSiteMapProvider generato automaticamente un Key oggetto per tenere traccia dei nodi.

Il FindSiteMapNodeFromKey metodo potrebbe chiamare il BuildSiteMap metodo in tutti i provider figlio associati al provider corrente. Pertanto, le eccezioni descritte nel BuildSiteMap metodo potrebbero essere generate.

Vedi anche

• FindSiteMapNode