StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Recupera um SiteMapNode objeto com base numa 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.SiteMapNodePublic Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParâmetros
- key
- String
Uma chave de pesquisa com a qual um SiteMapNode é criado.
Devoluções
A SiteMapNode que representa a página identificada por key; caso contrário, null, se o ajuste de segurança estiver ativado e o nó do mapa do site não puder ser mostrado ao utilizador atual ou se o nó do mapa do site não for encontrado na coleção de nós do mapa do sítio por key.
Observações
O FindSiteMapNodeFromKey método recupera um nó de mapa de sítios a partir de um objeto interno Hashtable com base em key.
O objeto XmlSiteMapProvider, que deriva da classe StaticSiteMapProvider e é o fornecedor padrão de mapas de sites para ASP.NET, utiliza a propriedade Url de um objeto SiteMapNode como chave de consulta nas suas coleções internas, por defeito. Se a Url propriedade de o SiteMapNode for definida, deve ser única dentro do âmbito do fornecedor do mapa do sítio. O FindSiteMapNode método tenta recuperar nós de mapas de sítios com base nos seus Url. Caso contrário, pode usar a Key propriedade e o método correspondente FindSiteMapNodeFromKey para recuperar os nós do mapa do site.
Tem StaticSiteMapProvider uma implementação padrão que procura instâncias da SiteMapNode classe com base no key parâmetro. Se um fornecedor de mapas de sítio usou o AddNode método, já StaticSiteMapProvider terá armazenado uma referência a cada SiteMapNode um com base no valor da SiteMapNode.Key propriedade. Por defeito, gera XmlSiteMapProvider GUIDs para instâncias da SiteMapNode classe que não têm valor para a SiteMapNode.Url propriedade. Os implementadores de fornecedores de mapas personalizados de sítios devem fornecer o seu próprio mecanismo para gerar valores únicos da SiteMapNode.Key propriedade caso uma instância da SiteMapNode classe não tenha valor para a SiteMapNode.Url propriedade.
As classes SiteMapProvider e XmlSiteMapProvider, que são a implementação padrão do site map para ASP.NET, utilizam o URL de um objeto SiteMapNode como chave nas várias coleções que as classes mantêm.
