SiteMapProvider.GetParentNodeRelativeToNodeAndHintDownFromParent Método

Definição

Fornece um método de pesquisa otimizado para provedores de mapa de site ao recuperar um nó ancestral para o objeto SiteMapNode especificado e ao buscar seus nós filho.

public:
 virtual System::Web::SiteMapNode ^ GetParentNodeRelativeToNodeAndHintDownFromParent(System::Web::SiteMapNode ^ node, int walkupLevels, int relativeDepthFromWalkup);
public virtual System.Web.SiteMapNode GetParentNodeRelativeToNodeAndHintDownFromParent (System.Web.SiteMapNode node, int walkupLevels, int relativeDepthFromWalkup);
abstract member GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
override this.GetParentNodeRelativeToNodeAndHintDownFromParent : System.Web.SiteMapNode * int * int -> System.Web.SiteMapNode
Public Overridable Function GetParentNodeRelativeToNodeAndHintDownFromParent (node As SiteMapNode, walkupLevels As Integer, relativeDepthFromWalkup As Integer) As SiteMapNode

Parâmetros

node
SiteMapNode

O SiteMapNode que funciona como um ponto de referência para walkupLevels e relativeDepthFromWalkup.

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

SiteMapNode

Um SiteMapNode que representa um ancestral de node; 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

O valor especificado para walkupLevels ou relativeDepthFromWalkup é menor que 0.

node é null.

Comentários

A implementação padrão da SiteMapProvider classe fornece uma implementação não otimizada do GetParentNodeRelativeToNodeAndHintDownFromParent método, chamando o método e HintNeighborhoodNodes os HintAncestorNodes métodos; no entanto, os provedores de mapa de site podem substituir o GetParentNodeRelativeToNodeAndHintDownFromParent 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 GetParentNodeRelativeToNodeAndHintDownFromParent método é muito semelhante ao GetParentNodeRelativeToCurrentNodeAndHintDownFromParent método.

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 GetParentNodeRelativeToNodeAndHintDownFromParent método, usando o e ChildNodes as ParentNode propriedades. Se houver menos níveis de nó ancestral do que especificado pelo upLevel parâmetro, null será retornado. Cabe ao implementador do provedor decidir como lidar com a situação em que o número de níveis de nó descendente disponíveis é menor do que o valor especificado pelo downLevel parâmetro.

Aplica-se a

Confira também