SiteMapProvider.FindSiteMapNodeFromKey(String) Metodo

Definizione

Recupera un oggetto SiteMapNode a partire da una chiave specificata.Retrieves a SiteMapNode object based on a specified key.

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.A lookup key with which a SiteMapNode is created.

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.A SiteMapNode that represents the page identified by key; otherwise, null, if no corresponding SiteMapNode is found or if security trimming is enabled and the SiteMapNode cannot be returned for the current user. Il valore predefinito è null.The default is null.

Commenti

L' SiteMapProvider implementazione restituisce null in tutti i casi.The SiteMapProvider implementation returns null in all cases. Le classi che derivano SiteMapProvider dalla classe possono eseguire FindSiteMapNodeFromKey l'override del metodo per fornire la funzionalità di ricerca in base a una chiave univoca, anziché a un FindSiteMapNode URL, che viene usata dal metodo.Classes that derive from the SiteMapProvider class can override the FindSiteMapNodeFromKey method to provide lookup functionality based on a unique key (instead of a URL, which is used by the FindSiteMapNode method). Implementare il FindSiteMapNodeFromKey metodo se l'implementazione del provider della mappa del SiteMapNode.Key sito usa la SiteMapNode proprietà di un oggetto come identificatore primario in una struttura della mappa del sito.Implement the FindSiteMapNodeFromKey method if your site map provider implementation uses the SiteMapNode.Key property of a SiteMapNode object as a primary identifier in a site map structure.

La StaticSiteMapProvider classe fornisce un'implementazione di che gestisce la ricerca dei nodi della mappa del sito che non definiscono un URL.The StaticSiteMapProvider class provides an implementation that handles searching for site map nodes that do not define a URL.

La XmlSiteMapProvider classe, che è il provider della mappa del sito predefinito per ASP.NET, usa l'URL SiteMapNode di un come chiave nelle varie raccolte gestite dalle classi.The XmlSiteMapProvider class, which is the default site map provider for ASP.NET, uses the URL of a SiteMapNode as a key in the various collections that the classes maintain. Pertanto, se un nodo fornisce un URL, deve essere univoco all'interno dell'ambito del provider della mappa del sito.Therefore, if a node provides a URL, it must be unique within the scope of the site map provider. Se non viene specificato alcun URL, viene generato un identificatore univoco per identificare SiteMapNode.If no URL is provided, a unique identifier is generated to identify the SiteMapNode.

Si applica a

Vedi anche