SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 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 de pesquisa otimizado para fornecedores de mapas de site ao recuperar um nó ancestral para a página atualmente solicitada e obter os nós descendentes do antepassado.
public:
virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);public virtual System.Web.SiteMapNode GetParentNodeRelativeToCurrentNodeAndHintDownFromParent(int walkupLevels, int relativeDepthFromWalkup);abstract member GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent : int * int -> System.Web.SiteMapNodePublic Overridable Function GetParentNodeRelativeToCurrentNodeAndHintDownFromParent (walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNodeParâmetros
- walkupLevels
- Int32
O número de níveis de nó ancestral a percorrer ao recuperar o nó ancestral solicitado.
- relativeDepthFromWalkup
- Int32
O número de níveis de nó descendente a recuperar do nó ancestral alvo.
Devoluções
A SiteMapNode que representa um antepassado SiteMapNode da página atualmente solicitada; caso contrário, null, se o atual ou antepassado SiteMapNode não for encontrado ou não puder ser devolvido ao utilizador atual.
Exceções
walkupLevels ou relativeDepthFromWalkup é inferior a 0.
Observações
A implementação padrão da SiteMapProvider classe fornece uma implementação não otimizada do GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método, chamando os GetCurrentNodeAndHintAncestorNodes métodos e; HintNeighborhoodNodes no entanto, os fornecedores de mapas de site podem sobrescrever o GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método e fornecer uma implementação otimizada que utiliza mecanismos de cache personalizados para devolver o nó ancestral e realizar uma pesquisa otimizada dos outros SiteMapNode objetos.
O walkupLevels parâmetro é usado para especificar quantos níveis de nós progenitores e antepassados deve atravessar ao recuperar o nó alvo. Se existirem menos níveis do que os solicitados, null é devolvido. O downLevel parâmetro é usado para especificar quantos níveis de nós descendentes do nó ancestral alvo devem ser recuperados. Se preferido, os nós antepassado e descendente podem ser ligados ao SiteMapNode que é devolvido pelo GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método, usando as ParentNode propriedades e ChildNodes .
