StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitProtected 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
node é null.
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.