StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Web
Assembly:
System.Web.dll

Aggiunge una classe SiteMapNode agli insiemi gestiti dal provider della mappa del sito e stabilisce una relazione padre/figlio tra gli oggetti SiteMapNode.

protected public:
 override void AddNode(System::Web::SiteMapNode ^ node, System::Web::SiteMapNode ^ parentNode);
protected internal override void AddNode (System.Web.SiteMapNode node, System.Web.SiteMapNode parentNode);
override this.AddNode : System.Web.SiteMapNode * System.Web.SiteMapNode -> unit
Protected Friend Overrides Sub AddNode (node As SiteMapNode, parentNode As SiteMapNode)

Parametri

node
SiteMapNode

Classe SiteMapNode da aggiungere al provider della mappa del sito.

parentNode
SiteMapNode

Classe SiteMapNode in cui aggiungere node.

Eccezioni

ArgumentNullException

node è null.

InvalidOperationException

La proprietà Url o Key è già stata registrata con la classe StaticSiteMapProvider. Un nodo della mappa del sito deve essere composto da pagine con URL o chiavi univoci.

Commenti

Il nodo mappa del sito identificato dal node parametro viene aggiunto a una raccolta interna e viene creata una relazione padre-figlio tra di esso e il parentNode nodo mappa del sito identificato dal parametro .

L'URL per un nodo della mappa del sito può essere interpretato quando viene aggiunto alle raccolte interne. Gli URL relativi e relativi dell'applicazione vengono espansi nei percorsi virtuali assoluti dell'applicazione, che vengono quindi usati internamente per archiviare e accedere alle singole istanze della SiteMapNode classe. Altri URL, ad esempio percorsi fisici, percorsi con protocolli in essi e percorsi UNC, non vengono interpretati.

La XmlSiteMapProvider classe, derivata 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à 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 alla relativa Url proprietà. In caso contrario, è possibile usare la proprietà e il Key metodo corrispondente FindSiteMapNodeFromKey per recuperare i nodi della mappa del sito. Se non Url viene specificato alcun valore o Key , il provider di mappe del sito genera automaticamente un Key oggetto per tenere traccia dei nodi della mappa del sito.

Note per gli eredi

Quando si esegue l'override del AddNode(SiteMapNode, SiteMapNode) metodo, assicurarsi che la Key proprietà sia impostata su un valore univoco quando si aggiunge il nodo della mappa del sito usando il AddNode metodo .

Si applica a

Vedi anche