StaticSiteMapProvider.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 SiteMapNode oggetto in base a 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
Chiave di ricerca con cui viene creato un oggetto SiteMapNode .
Restituisce
Oggetto SiteMapNode che rappresenta la pagina identificata da key; in caso contrario, null, se la rimozione della sicurezza è abilitata e il nodo della mappa del sito non può essere visualizzato all'utente corrente o il nodo della mappa del sito non viene trovato nella raccolta di nodi della mappa del sito da key.
Commenti
Il FindSiteMapNodeFromKey metodo recupera un nodo della mappa del sito da un oggetto interno Hashtable basato su key.
L'oggetto XmlSiteMapProvider , derivato dalla StaticSiteMapProvider classe ed è il provider predefinito della mappa del sito 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à di SiteMapNode è impostata, deve essere univoca nell'ambito del provider della mappa del sito. Il FindSiteMapNode metodo tenta di recuperare i nodi della mappa del sito in base al relativo Urloggetto . In caso contrario, è possibile utilizzare la Key proprietà e il metodo corrispondente FindSiteMapNodeFromKey per recuperare i nodi della mappa del sito.
ha StaticSiteMapProvider un'implementazione predefinita che cerca le istanze della SiteMapNode classe in base al key parametro . Se un implementatore del provider della mappa del sito ha usato il AddNode metodo , l'oggetto StaticSiteMapProvider ha già archiviato un riferimento a ognuno SiteMapNode in base al valore della SiteMapNode.Key proprietà. Per impostazione predefinita, genera XmlSiteMapProvider GUID per le istanze della SiteMapNode classe che non hanno un valore per la SiteMapNode.Url proprietà . Gli implementatori del provider della mappa del sito personalizzato devono fornire il proprio meccanismo per generare valori univoci della SiteMapNode.Key proprietà nel caso in cui un'istanza della SiteMapNode classe non abbia un valore per la SiteMapNode.Url proprietà .
Le SiteMapProvider classi e XmlSiteMapProvider , ovvero l'implementazione predefinita del provider della mappa del sito per ASP.NET, usano l'URL di un SiteMapNode oggetto come chiave nelle varie raccolte gestite dalle classi.
