XmlSiteMapProvider.FindSiteMapNode(String) Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Recupera um objeto SiteMapNode 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 um SiteMapNodeserá recuperado.

Retornos

SiteMapNode

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

Exceções

ProviderException

Um provedor filho vinculado ao provedor de mapa de site atual retornado de um nó que não é válido.

Comentários

O objeto substitui o 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 XmlSiteMapProvider FindSiteMapNode a URL especificada.

O parâmetro deve ser um caminho virtual absoluto ou um caminho relativo ao aplicativo, dependendo de como ele é especificado no arquivo de dados do rawUrl mapa do site XML.

A classe e as classes derivadas dela usam a URL de um objeto como uma chave nas várias coleções que XmlSiteMapProvider SiteMapNode a classe mantém. Portanto, essas URLs devem ser exclusivas dentro do escopo do mapa do site. Se a URL não for encontrada nos dados imediatos do mapa do site gerenciados pelo , ele chamará o em cada provedor filho que está vinculado a ela por meio do atributo de seus nós de XmlSiteMapProvider FindSiteMapNode mapa do provider site.

O FindSiteMapNode método chama indiretamente o método para recuperar BuildSiteMap o nó de nível superior no mapa do site. Portanto, todas as exceções que ocorrem para BuildSiteMap o método também podem ocorrer ao chamar o método FindSiteMapNode .

Confira também

• GetRootNodeCore()
• BuildSiteMap()