XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Método

Definição

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.SiteMapNode
Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parâmetros

key
String

Uma chave de pesquisa para procurar um SiteMapNode.

Devoluções

A que representa a página identificada por SiteMapNode; caso contrário, key, se o null ajuste de segurança estiver ativado e o nó não puder ser mostrado ao utilizador atual ou se o nó não for encontrado por key na coleção de nós.

Exceções

Um fornecedor filho ligado ao fornecedor atual de mapas do site devolveu um nó que não é válido.

Observações

A XmlSiteMapProvider classe sobrescreve o FindSiteMapNodeFromKey método para garantir que quaisquer fornecedores filhos ligados sejam pesquisados pelo nó, caso a implementação da classe base não devolva um nó para key.

O objeto XmlSiteMapProvider, derivado da classe StaticSiteMapProvider e do fornecedor padrão de mapas do site 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. Se não Url for especificado, gera XmlSiteMapProvider automaticamente a Key para acompanhar os nós.

O FindSiteMapNodeFromKey método pode referir-se BuildSiteMap a qualquer prestador infantil associado ao prestador atual. Portanto, as exceções descritas no BuildSiteMap método podem ser lançadas.

Aplica-se a

Ver também