StaticSiteMapProvider.FindSiteMapNode(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 que representa a página na URL especificada.
public:
override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);public override System.Web.SiteMapNode FindSiteMapNode(string rawUrl);override this.FindSiteMapNode : string -> System.Web.SiteMapNodePublic Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNodeParâmetros
- rawUrl
- String
Uma URL que identifica a página para a qual recuperar um SiteMapNode.
Devoluções
A que representa a página identificada por SiteMapNode; caso contrário, rawURL, se não for encontrado nenhum nó correspondente no null mapa do sítio.
Exceções
rawURL é null.
Observações
O URL fornecido é tipicamente um URL virtual ou absoluto. Pode também ser uma URL que utiliza ASP.NET sintaxe relativa à aplicação, como "~/apprelativedirectory". A StaticSiteMapProvider classe normaliza automaticamente os URLs brutos relativos à aplicação para um caminho virtual absoluto.
O objeto XmlSiteMapProvider, que deriva do StaticSiteMapProvider e é o fornecedor padrão de mapas de 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 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. Se não Url for especificado o ou Key do local, o fornecedor do mapa do sítio gera automaticamente uma Key propriedade para acompanhar os nós do mapa do sítio.
Notas para Herdeiros
Ao sobrescrever o FindSiteMapNode(String) método numa classe derivada, certifique-se de normalizar as URLs dos SiteMapNode objetos que adiciona ao seu fornecedor de mapas de sites, para que o FindSiteMapNode(String) método possa recuperar um nó de mapa de sites independentemente de a URL do nó de mapa de site ser fornecida como um caminho virtual absoluto ou como um caminho relativo à aplicação.
O comportamento de corte de segurança está incluído nas SiteMapProvider implementações da classe e.StaticSiteMapProvider No entanto, para que o trimming de segurança funcione em classes derivadas, deve definir a Roles propriedade de quaisquer SiteMapNode objetos que crie ao construir um fornecedor de mapas de site ao sobrepor o BuildSiteMap() método.
