StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Méthode

Définition

Ajoute un SiteMapNode aux collections conservées par le fournisseur de plan de site et établit une relation parent/enfant entre les objets 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)

Paramètres

node
SiteMapNode

SiteMapNode à ajouter au fournisseur de plan de site.

parentNode
SiteMapNode

SiteMapNode auquel ajouter le node.

Exceptions

node a la valeur null.

Le Url ou le Key est déjà enregistré avec le StaticSiteMapProvider. Un nœud de plan de site doit être composé de pages dotées d'URL ou de clés uniques.

Remarques

Le nœud de carte de site identifié par le node paramètre est ajouté à une collection interne et une relation parent-enfant est créée entre elle et le nœud de carte de site identifié par le parentNode paramètre.

L’URL d’un nœud de mappage de site peut être interprétée lorsqu’il est ajouté aux collections internes. Les URL relatives et relatives de l’application sont étendues aux chemins virtuels absolus d’application, qui sont ensuite utilisés en interne pour stocker et accéder aux instances individuelles de la SiteMapNode classe. D’autres URL, telles que des chemins physiques, des chemins avec des protocoles dans eux, et des chemins UNC, ne sont pas interprétés.

La XmlSiteMapProvider classe, dérivée de la StaticSiteMapProvider classe et qui est le fournisseur de carte de site par défaut pour ASP.NET, utilise la Url propriété d’un SiteMapNode objet comme clé de recherche dans ses collections internes, par défaut. Si la Url propriété du SiteMapNode jeu est définie, elle doit être unique dans l’étendue du fournisseur de carte de site. La FindSiteMapNode méthode tente de récupérer des nœuds de mappage de site en fonction de leur Url propriété. Sinon, vous pouvez utiliser la Key propriété et la méthode correspondante FindSiteMapNodeFromKey pour récupérer les nœuds de carte de site. Si aucun ou Key n’est Url spécifié, le fournisseur de carte de site génère automatiquement un Key pour suivre les nœuds de carte de site.

Notes pour les héritiers

En cas de substitution de la AddNode(SiteMapNode, SiteMapNode) méthode, vérifiez que la Key propriété est définie sur une valeur unique lors de l’ajout du nœud de carte de site à l’aide de la AddNode méthode.

S’applique à

Voir aussi