XmlSiteMapProvider.FindSiteMapNode(String) 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.
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 .