XmlSiteMapProvider.FindSiteMapNode(String) Método

Definição

Recupera um SiteMapNode objeto que representa a página na URL especificada.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);
public override System.Web.SiteMapNode FindSiteMapNode(string rawUrl);
override this.FindSiteMapNode : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode

Parâmetros

rawUrl
String

Uma URL que identifica a página para a qual recuperar um SiteMapNode.

Devoluções

A SiteMapNode que representa a página identificada por rawURL.

Exceções

Um fornecedor filho ligado ao fornecedor atual de mapas do site devolveu um nó que não é válido.

Observações

O XmlSiteMapProvider objeto sobrepõe o FindSiteMapNode método para garantir que quaisquer fornecedores filhos ligados sejam pesquisados pelo nó caso a implementação da classe base não devolva um nó para a URL especificada.

O rawUrl parâmetro deve ser ou um caminho virtual absoluto ou um caminho relativo à aplicação, dependendo de como é especificado no ficheiro de dados do mapa do site XML.

A XmlSiteMapProvider classe e as classes que dela derivam utilizam a URL de um SiteMapNode objeto como chave nas várias coleções que a classe mantém. Portanto, estas URLs devem ser únicas dentro do âmbito do mapa do site. Se a URL não for encontrada nos dados imediatos do mapa do site geridos pelo XmlSiteMapProvider, chama o FindSiteMapNode em cada fornecedor filho que está ligado através do provider atributo dos seus nós do mapa do sítio.

O FindSiteMapNode método chama indiretamente o BuildSiteMap método para recuperar o nó de topo no mapa do site. Portanto, quaisquer exceções que ocorram para o BuildSiteMap método também podem ocorrer ao chamá-lo FindSiteMapNode .

Aplica-se a

Ver também