StaticSiteMapProvider.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 pelo rawURL; caso contrário, null, se nenhum nó de mapa de site correspondente for encontrado.

Exceções

ArgumentNullException

rawURL é null.

Comentários

A URL fornecida normalmente é uma URL virtual ou absoluta. Também pode ser uma URL que usa ASP.NET sintaxe relativa ao aplicativo, como "~/apprelativedirectory". A StaticSiteMapProvider classe normaliza automaticamente URLs brutas relativas ao aplicativo para um caminho virtual absoluto.

O XmlSiteMapProvider objeto, que é derivado do StaticSiteMapProvider provedor de mapa de site padrão para ASP.NET, usa a Url propriedade de um SiteMapNode objeto como uma chave de pesquisa em suas coleções internas, por padrão. Se a Url propriedade do SiteMapNode conjunto for definida, ela deverá ser exclusiva dentro do escopo do provedor de mapa do site. O FindSiteMapNode método tenta recuperar nós de mapa do site com base em seus Urlnós . Caso contrário, você pode usar a Key propriedade e o método correspondente FindSiteMapNodeFromKey para recuperar nós de mapa do site. Se não Url for especificado ou Key não, o provedor de mapa do site gerará automaticamente uma Key propriedade para acompanhar os nós de mapa do site.

Notas aos Herdeiros

Ao substituir o FindSiteMapNode(String) método em uma classe derivada, certifique-se de normalizar as URLs dos SiteMapNode objetos que você adiciona ao provedor de mapa de site, para que o FindSiteMapNode(String) método possa recuperar um nó de mapa do site, independentemente de a URL do nó de mapa do site ser fornecida como um caminho virtual absoluto ou um caminho relativo do aplicativo.

O comportamento de corte de segurança é incluído nas implementações de classe e StaticSiteMapProvider na SiteMapProvider classe. No entanto, para que o corte de segurança funcione em classes derivadas, você deve definir a propriedade de todos SiteMapNode os Roles objetos criados durante a criação de um provedor de mapa de site ao substituir o BuildSiteMap() método.

Confira também

• BuildSiteMap()
• FindSiteMapNodeFromKey(String)