StaticSiteMapProvider.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 um SiteMapNode é criado.

Retornos

SiteMapNode

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

Comentários

O FindSiteMapNodeFromKey método recupera um nó de mapa de site de um objeto interno Hashtable com base em key.

O XmlSiteMapProvider objeto, que é derivado da StaticSiteMapProvider classe e é o 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.

O StaticSiteMapProvider tem uma implementação padrão que pesquisa instâncias da SiteMapNode classe com base no key parâmetro. Se um implementador de provedor de mapa de site tiver usado o AddNode método, o StaticSiteMapProvider já terá armazenado uma referência a cada SiteMapNode um com base no valor da SiteMapNode.Key propriedade. Por padrão, gera XmlSiteMapProvider GUIDs para instâncias da SiteMapNode classe que não têm um valor para a SiteMapNode.Url propriedade. Os implementadores personalizados do provedor de mapa de site devem fornecer seu próprio mecanismo para gerar valores exclusivos da SiteMapNode.Key propriedade no caso de uma instância da SiteMapNode classe não ter um valor para a SiteMapNode.Url propriedade.

As SiteMapProvider classes e XmlSiteMapProvider as classes, que são a implementação padrão do provedor de mapa de site para ASP.NET, usam a URL de um SiteMapNode objeto como uma chave nas várias coleções que as classes mantêm.

Confira também

• FindSiteMapNode