SiteMapProvider.HintAncestorNodes(SiteMapNode, Int32) 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.
Fornece um método que os fornecedores de mapas de site podem sobrepor para realizar uma recuperação otimizada de um ou mais níveis de nós pai e ancestral, relativamente ao objeto especificado SiteMapNode .
public:
virtual void HintAncestorNodes(System::Web::SiteMapNode ^ node, int upLevel);public virtual void HintAncestorNodes(System.Web.SiteMapNode node, int upLevel);abstract member HintAncestorNodes : System.Web.SiteMapNode * int -> unit
override this.HintAncestorNodes : System.Web.SiteMapNode * int -> unitPublic Overridable Sub HintAncestorNodes (node As SiteMapNode, upLevel As Integer)Parâmetros
- node
- SiteMapNode
O SiteMapNode que atua como ponto de referência para upLevel.
- upLevel
- Int32
O número de gerações de antepassados SiteMapNode para ir buscar. 0 indica que nenhum nós antepassado é recuperado e -1 indica que todos os antepassados podem ser recuperados e armazenados em cache.
Exceções
upLevel é inferior a -1.
node é null.
Observações
O método padrão HintAncestorNodes verifica apenas um upLevel parâmetro que seja inferior a -1 e um node parâmetro que seja null. Como a XmlSiteMapProvider classe armazena em cache a informação do mapa do site na memória, o HintAncestorNodes método não é utilizado.
Os fornecedores de mapas de site podem sobrepor o HintAncestorNodes método para realizar uma recuperação otimizada dos nós pai e antepassado do objeto especificado SiteMapNode .
O upLevel parâmetro é usado para especificar quantos níveis de nós progenitores e antepassados atravessar a partir do especificado SiteMapNode. Se existirem menos níveis do que o solicitado, todos os nós ancestrais disponíveis são devolvidos dentro do limite especificado. Se preferido, o nó pai pode ser ligado ao especificado SiteMapNode usando a ParentNode propriedade.
