Condividi tramite


StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Metodo

Definizione

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.SiteMapNode
Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parametri

key
String

Chiave di ricerca con cui viene creato un elemento SiteMapNode.

Restituisce

Classe SiteMapNode che rappresenta la pagina identificata da key; in caso contrario, null, se è attivata la rimozione di sicurezza e il nodo della mappa del sito non può essere mostrato all'utente corrente oppure il nodo della mappa del sito non viene trovato da key nell'insieme della mappa del sito.

Commenti

Il FindSiteMapNodeFromKey metodo recupera un nodo della mappa del sito da un oggetto interno Hashtable basato su key.

L'oggetto XmlSiteMapProviderStaticSiteMapProvider , derivato dalla 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à dell'oggetto SiteMapNode è impostata, deve essere univoca nell'ambito del provider di mappe del sito. Il FindSiteMapNode metodo tenta di recuperare i nodi della mappa del sito in base al relativo Url. In caso contrario, è possibile usare la proprietà e il Key metodo corrispondente FindSiteMapNodeFromKey per recuperare i nodi della mappa del sito.

Ha StaticSiteMapProvider un'implementazione predefinita che cerca istanze della classe in base al keySiteMapNode parametro. Se un provider di mapping 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, il XmlSiteMapProvider GUID genera le istanze della SiteMapNode classe che non hanno un valore per la SiteMapNode.Url proprietà. Gli implementatori del provider di mapping 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 di mapping del sito per ASP.NET, usano l'URL di un SiteMapNode oggetto come chiave nelle varie raccolte gestite dalle classi.

Si applica a

Vedi anche