XmlSiteMapProvider.FindSiteMapNode(String) 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.
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.SiteMapNodePublic Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNodeParâmetros
- rawUrl
- String
Uma URL que identifica a página para a qual recuperar um SiteMapNode.
Retornos
Um SiteMapNode que representa a página identificada por rawURL.
Exceções
Um provedor filho vinculado ao provedor de mapa de site atual retornou um nó que não é válido.
Comentários
O XmlSiteMapProvider objeto substitui o FindSiteMapNode método para garantir que todos os provedores filho vinculados sejam pesquisados para o nó se a implementação da classe base não retornar um nó para a URL especificada.
O rawUrl parâmetro deve ser um caminho virtual absoluto ou um caminho relativo ao aplicativo, dependendo de como ele é especificado no arquivo de dados do mapa de site XML.
A XmlSiteMapProvider classe e as classes derivadas dela usam a URL de um SiteMapNode objeto como chave nas várias coleções que a classe mantém. Portanto, essas URLs devem ser exclusivas no escopo do mapa do site. Se a URL não for encontrada nos dados imediatos do mapa do XmlSiteMapProvidersite que são gerenciados pelo provedor filho, ela chamará cada FindSiteMapNode provedor filho vinculado a ele por meio do provider atributo de seus nós de mapa de site.
O FindSiteMapNode método chama indiretamente o BuildSiteMap método para recuperar o nó de nível superior no mapa do site. Portanto, todas as exceções que ocorrem para o BuildSiteMap método também podem ocorrer ao chamar o FindSiteMapNode método.
