XmlSiteMapProvider.FindSiteMapNodeFromKey(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 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.SiteMapNodePublic Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParametri
- key
- String
Una chiave di ricerca da utilizzare per individuare la classe SiteMapNode.
Restituisce
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
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.
