SiteMapProvider.FindSiteMapNodeFromKey(String) Método

Definição

Recupera um SiteMapNode objeto com base numa 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.

Devoluções

A que representa a página identificada por SiteMapNode; caso contrário, key, se não for encontrado nenhum correspondente null ou se o SiteMapNode ajuste de segurança estiver ativado e o SiteMapNode não puder ser devolvido ao utilizador atual. A predefinição é null.

Observações

A SiteMapProvider implementação retorna null em todos os casos. As classes que derivam da SiteMapProvider classe podem sobrepor o FindSiteMapNodeFromKey método para fornecer funcionalidade de pesquisa baseada numa chave única (em vez de uma URL, que é usada pelo FindSiteMapNode método). Implemente o FindSiteMapNodeFromKey método se a implementação do seu fornecedor de mapas de sítios usar a SiteMapNode.Key propriedade de um SiteMapNode objeto como identificador primário numa estrutura de mapa de sítio.

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

A classe XmlSiteMapProvider, que é o fornecedor padrão de mapas de sites para ASP.NET, utiliza o URL de um SiteMapNode como chave nas várias coleções que as classes mantêm. Portanto, se um nó fornecer uma URL, esta deve ser única dentro do âmbito do fornecedor do mapa do site. Se não for fornecido um URL, é gerado um identificador único para identificar o SiteMapNode.

Aplica-se a

Ver também