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 un oggetto SiteMapNode alle raccolte gestite dal provider della mappa del sito e stabilisce una relazione padre/figlio tra gli SiteMapNode oggetti .
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
Oggetto SiteMapNode da aggiungere al provider della mappa del sito.
- parentNode
- SiteMapNode
Oggetto SiteMapNode in cui aggiungere node.
Eccezioni
node è null.
l'oggetto Url o Key è già registrato con .StaticSiteMapProvider Un nodo della mappa del sito deve essere costituito da pagine con URL o chiavi univoci.
Commenti
Il nodo della node mappa del sito identificato dal parametro viene aggiunto a una raccolta interna e viene creata una relazione padre-figlio tra di essa e il nodo della mappa del parentNode sito identificato dal parametro .
L'URL di un nodo della mappa del sito può essere interpretato quando viene aggiunto alle raccolte interne. Gli URL relativi all'applicazione e relativi vengono espansi in 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 contenuti 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à 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 alla relativa Url proprietà. In caso contrario, è possibile utilizzare la Key proprietà e il metodo corrispondente FindSiteMapNodeFromKey per recuperare i nodi della mappa del sito. Se non viene specificato alcun Url valore o Key , il provider della mappa del sito genera automaticamente un oggetto Key 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 proprietà sia impostata su un valore univoco quando si Key aggiunge il nodo della mappa del sito usando il AddNode metodo .
