SiteMapProvider.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:
virtual System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public virtual System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
abstract member FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNode
Parametri
- key
- String
Chiave di ricerca con cui viene creato un elemento SiteMapNode.
Restituisce
Elemento SiteMapNode che rappresenta la pagina identificata da key
; in caso contrario null
se non viene trovato alcun elemento SiteMapNode corrispondente oppure se la rimozione di sicurezza è attivata e non è possibile restituire l'elemento SiteMapNode per l'utente corrente. Il valore predefinito è null
.
Commenti
L'implementazione SiteMapProvider restituisce null
in tutti i casi. Le classi che derivano dalla SiteMapProvider classe possono eseguire l'override del FindSiteMapNodeFromKey metodo per fornire funzionalità di ricerca basate su una chiave univoca (anziché un URL, usato dal FindSiteMapNode metodo ). Implementare il metodo se l'implementazione FindSiteMapNodeFromKey del provider della mappa del sito usa la SiteMapNode.Key proprietà di un SiteMapNode oggetto come identificatore primario in una struttura della mappa del sito.
La StaticSiteMapProvider classe fornisce un'implementazione che gestisce la ricerca di nodi della mappa del sito che non definiscono un URL.
La XmlSiteMapProvider classe , ovvero il provider predefinito della mappa del sito per ASP.NET, usa l'URL di un SiteMapNode oggetto come chiave nelle varie raccolte gestite dalle classi. Pertanto, se un nodo fornisce un URL, deve essere univoco nell'ambito del provider della mappa del sito. Se non viene specificato alcun URL, viene generato un identificatore univoco per identificare l'oggetto SiteMapNode.