XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Recupera um objeto SiteMapNode com base em uma chave especificada.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);

public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);

override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode

Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parâmetros

key

String

Uma chave de pesquisa com a qual procurar um SiteMapNode.

Retornos

SiteMapNode

Um SiteMapNode que representa a página identificada por key; caso contrário, null, se a filtragem de segurança estiver habilitada e o nó não puder ser mostrado para o usuário atual ou o nó não for encontrado por key na coleção de nós.

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

A classe 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 XmlSiteMapProvider FindSiteMapNodeFromKey nó para key .

O objeto , derivado da classe e do provedor de mapa do site padrão para ASP.NET, usa a propriedade de um objeto como uma chave de lookup em suas coleções XmlSiteMapProvider StaticSiteMapProvider Url SiteMapNode internas, por padrão. Se a Url propriedade do SiteMapNode estiver definida, ela deverá ser exclusiva dentro do escopo do provedor. Se nenhum Url for especificado, o XmlSiteMapProvider gerará automaticamente um Key para acompanhar os nós.

O FindSiteMapNodeFromKey método pode chamar o método em quaisquer BuildSiteMap provedores filho associados ao provedor atual. Portanto, as exceções descritas no BuildSiteMap método podem ser lançadas.

Confira também

• FindSiteMapNode