SiteMapProvider.FindSiteMapNodeFromKey(String) Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Recupera um objeto SiteMapNode com base em uma chave especificada.

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

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

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

Public Overridable 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 por key; caso contrário, null se nenhum SiteMapNode correspondente for encontrado ou se a restrição de segurança estiver habilitada e o SiteMapNode não puder ser retornado para o usuário atual. O padrão é null.

Comentários

A SiteMapProvider implementação retorna null em todos os casos. Classes que derivam da SiteMapProvider classe podem substituir o FindSiteMapNodeFromKey método para fornecer funcionalidade de pesquisa com base em uma chave exclusiva (em vez de uma URL, que é usada pelo FindSiteMapNode método). Implemente o método se a FindSiteMapNodeFromKey implementação do provedor de mapa do site usar a SiteMapNode.Key propriedade de um SiteMapNode objeto como um identificador primário em uma estrutura de mapa do site.

A StaticSiteMapProvider classe fornece uma implementação que manipula a pesquisa de nós de mapa do site que não definem uma URL.

A XmlSiteMapProvider classe, que é o provedor de mapa de site padrão para ASP.NET, usa a URL de uma SiteMapNode como chave nas várias coleções que as classes mantêm. Portanto, se um nó fornecer uma URL, ele deverá ser exclusivo dentro do escopo do provedor de mapa do site. Se nenhuma URL for fornecida, um identificador exclusivo será gerado para identificar o SiteMapNode.

Confira também

• FindSiteMapNode