StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Adiciona um SiteMapNode às coleções mantidas pelo provedor de mapa de site e estabelece uma relação pai/filho entre os objetos 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)

Parâmetros

node

SiteMapNode

O SiteMapNode a ser adicionado ao provedor de mapa de site.

parentNode

SiteMapNode

O SiteMapNode sob a qual adicionar o node.

Exceções

ArgumentNullException

node é null.

InvalidOperationException

O Url ou o Key já estão registrados com o StaticSiteMapProvider. Um nó de mapa de site deve ser composto de páginas com URLs ou chaves exclusivas.

Comentários

O nó de mapa do site que é identificado pelo node parâmetro é adicionado a uma coleção interna e uma relação pai-filho é criada entre ele e o nó de mapa do site que é identificado pelo parentNode parâmetro.

A URL de um nó de mapa do site pode ser interpretada quando é adicionada às coleções internas. URLs relativas e relativas do aplicativo são expandidas para caminhos virtuais absolutos do aplicativo, que são usados internamente para armazenar e acessar as instâncias individuais da SiteMapNode classe. Outras URLs, como caminhos físicos, caminhos com protocolos e caminhos UNC, não são interpretadas.

A XmlSiteMapProvider classe, que é derivada da StaticSiteMapProvider classe e é o provedor de mapa de site padrão para ASP.NET, usa a Url propriedade de um SiteMapNode objeto como uma chave de pesquisa em suas coleções internas, por padrão. Se a Url propriedade do SiteMapNode conjunto for definida, ela deverá ser exclusiva dentro do escopo do provedor de mapa do site. O FindSiteMapNode método tenta recuperar nós de mapa do site com base em sua Url propriedade. Caso contrário, você pode usar a Key propriedade e o método correspondente FindSiteMapNodeFromKey para recuperar nós de mapa do site. Se não Url for especificado ou Key não, o provedor de mapa do site gerará automaticamente um Key para acompanhar os nós do mapa do site.

Notas aos Herdeiros

Ao substituir o AddNode(SiteMapNode, SiteMapNode) método, verifique se a Key propriedade está definida como um valor exclusivo ao adicionar o nó de mapa do site usando o AddNode método.

Confira também

• RemoveNode(SiteMapNode)