StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Methode

Definition

Fügt den vom Siteübersichtsanbieter verwalteten Auflistungen einen SiteMapNode hinzu und richtet eine Über- bzw. Unterordnungsbeziehung zwischen den SiteMapNode-Objekten ein.Adds a SiteMapNode to the collections that are maintained by the site map provider and establishes a parent/child relationship between the SiteMapNode objects.

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)

Parameter

node
SiteMapNode

Der dem Siteübersichtsanbieter hinzuzufügende SiteMapNode.The SiteMapNode to add to the site map provider.

parentNode
SiteMapNode

Der SiteMapNode, unter dem node hinzugefügt werden soll.The SiteMapNode under which to add node.

Ausnahmen

node ist null.node is null.

Der Url oder der Key ist bereits beim StaticSiteMapProvider registriert.The Url or Key is already registered with the StaticSiteMapProvider. Ein Siteübersichtsknoten muss aus Seiten mit eindeutigen URLs oder Schlüsseln bestehen.A site map node must be made up of pages with unique URLs or keys.

Hinweise

Der durch den node -Parameter identifizierte Site Übersichts Knoten wird einer internen Auflistung hinzugefügt, und zwischen diesem und dem durch den parentNode -Parameter identifizierten Site Übersichts Knoten wird eine Beziehung zwischen über-und untergeordneten Elementen erstellt.The site map node that is identified by the node parameter is added to an internal collection and a parent-child relationship is created between it and the site map node that is identified by the parentNode parameter.

Die URL für einen Site Übersichts Knoten wird möglicherweise interpretiert, wenn er den internen Auflistungen hinzugefügt wird.The URL for a site map node might be interpreted when it is added to the internal collections. Anwendungs relative und relative URLs werden auf virtuelle Anwendungs absolute Pfade erweitert, die dann intern verwendet werden, um die einzelnen Instanzen der SiteMapNode Klasse zu speichern und darauf zuzugreifen.Application-relative and relative URLs are expanded to application-absolute virtual paths, which are then used internally to store and access the individual instances of the SiteMapNode class. Andere URLs, z. b. physische Pfade, Pfade mit Protokollen in Ihnen und UNC-Pfade, werden nicht interpretiert.Other URLs, such as physical paths, paths with protocols in them, and UNC paths, are not interpreted.

Die XmlSiteMapProvider -Klasse, die von der StaticSiteMapProvider -Klasse abgeleitet ist und der Standard-Site Übersichts Anbieter für ASP.net, SiteMapNode verwendet Url standardmäßig die-Eigenschaft eines-Objekts als Suchschlüssel in den internen Auflistungen.The XmlSiteMapProvider class, which is derived from the StaticSiteMapProvider class, and is the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. Wenn die Url -Eigenschaft SiteMapNode von festgelegt ist, muss Sie innerhalb des Bereichs des Site Übersichts Anbieters eindeutig sein.If the Url property of the SiteMapNode is set, it must be unique within the scope of the site map provider. Die FindSiteMapNode -Methode versucht, Site Übersichts Knoten auf der Grundlage Url ihrer-Eigenschaft abzurufen.The FindSiteMapNode method attempts to retrieve site map nodes based on their Url property. Andernfalls können Sie die Key -Eigenschaft und die entsprechende FindSiteMapNodeFromKey -Methode zum Abrufen von Site Übersichts Knoten verwenden.Otherwise, you can use the Key property and the corresponding FindSiteMapNodeFromKey method to retrieve site map nodes. Wenn weder Url noch Key angegeben wird, generiert der Site Übersichts Anbieter automatisch eine Key zum Nachverfolgen der Site Übersichts Knoten.If no Url or Key is specified, the site map provider automatically generates a Key to track the site map nodes.

Hinweise für Vererber

Stellen Sie beim AddNode(SiteMapNode, SiteMapNode) Überschreiben der-Methode Key sicher, dass die-Eigenschaft beim Hinzufügen des Site Übersichts Knotens mithilfe AddNode der-Methode auf einen eindeutigen Wert festgelegt wird.When overriding the AddNode(SiteMapNode, SiteMapNode) method, ensure that the Key property is set to a unique value when adding the site map node using the AddNode method.

Gilt für:

Siehe auch