SiteMapProvider.FindSiteMapNodeFromKey(String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.SiteMapNodePublic Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParâmetros
- key
- String
Uma chave de pesquisa com a qual um SiteMapNode é criado.
Retornos
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.