Condividi tramite


SiteMapProvider.FindSiteMapNodeFromKey(String) Metodo

Definizione

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

SiteMapNode

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.

Si applica a

Vedi anche