SiteMapProvider.GetParentNodeRelativeToCurrentNodeAndHintDownFromParent 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.
Fornece um método de pesquisa otimizado para provedores de mapa de site ao recuperar um nó ancestral para a página solicitada no momento e ao buscar os nós descendentes para o ancestral.
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 ser percorrido ao recuperar o nó ancestral solicitado.
- relativeDepthFromWalkup
- Int32
O número de níveis de nós descendentes a ser recuperado do nó ancestral de destino.
Retornos
Um SiteMapNode que representa um SiteMapNode ancestral da página solicitada no momento; caso contrário, null, se o SiteMapNode atual ou ancestral não for localizado nem puder ser retornado para o usuário atual.
Exceções
walkupLevels ou relativeDepthFromWalkup é menor que 0.
Comentários
A implementação padrão da SiteMapProvider classe fornece uma implementação não otimizada do GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método, chamando o método e HintNeighborhoodNodes os GetCurrentNodeAndHintAncestorNodes métodos; no entanto, os provedores de mapa de site podem substituir o GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método e fornecer uma implementação otimizada que usa mecanismos de cache personalizados para retornar o nó ancestral e executar uma pesquisa otimizada dos outros SiteMapNode objetos.
O walkupLevels parâmetro é usado para especificar quantos níveis de nós pai e ancestral devem ser percorridos ao recuperar o nó de destino. Se houver menos níveis do que os solicitados, null será retornado. O downLevel parâmetro é usado para especificar quantos níveis de nós descendentes do nó ancestral de destino recuperar. Se preferir, os nós ancestrais e descendentes podem ser vinculados ao SiteMapNode que é retornado pelo GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método, usando o e ChildNodes as ParentNode propriedades.