StaticSiteMapProvider.AddNode(SiteMapNode, SiteMapNode) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Adiciona a SiteMapNode às coleções mantidas pelo fornecedor do mapa do site e estabelece uma relação pai/filho entre os SiteMapNode objetos.
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 para adicionar ao fornecedor de mapas do site.
- parentNode
- SiteMapNode
O SiteMapNode sob o qual adicionar node.
Exceções
node é null.
O Url ou Key já está registado no StaticSiteMapProvider. Um nó de mapa do site deve ser composto por páginas com URLs ou chaves únicas.
Observações
O nó do mapa do sítio identificado pelo node parâmetro é adicionado a uma coleção interna e cria-se uma relação pai-filho entre este e o nó do mapa do sítio, que é identificado pelo parentNode parâmetro.
O URL de um nó de mapa de site pode ser interpretado quando é adicionado às coleções internas. As URLs relativas e relativas à aplicação são expandidas para caminhos virtuais absolutos da aplicação, que são depois usados internamente para armazenar e aceder às instâncias individuais da SiteMapNode classe. Outros URLs, como caminhos físicos, caminhos com protocolos e caminhos UNC, não são interpretados.
A classe XmlSiteMapProvider, que deriva da classe StaticSiteMapProvider e é o fornecedor padrão de mapas de sites para ASP.NET, utiliza a propriedade Url de um objeto SiteMapNode como chave de consulta nas suas coleções internas, por defeito. Se a Url propriedade de o SiteMapNode for definida, deve ser única dentro do âmbito do fornecedor do mapa do sítio. O FindSiteMapNode método tenta recuperar nós do mapa do sítio com base nas suas Url propriedades. Caso contrário, pode usar a Key propriedade e o método correspondente FindSiteMapNodeFromKey para recuperar os nós do mapa do site. Se não Url for especificado ou ou (OR Key ), o fornecedor do mapa do local gera automaticamente um Key para acompanhar os nós do mapa do sítio.
Notas para Herdeiros
Ao sobrescrever o AddNode(SiteMapNode, SiteMapNode) método, certifique-se de que a Key propriedade está definida com um valor único ao adicionar o nó do mapa do site usando o AddNode método.
