StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) 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.
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 -> unitProtected 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
node è null.
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 .
