StaticSiteMapProvider.FindSiteMapNode(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 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.
Retornos
Um SiteMapNode que representa a página identificada por rawURL; caso contrário, nullse nenhum nó de mapa de site correspondente for encontrado.
Exceções
rawURL é null.
Comentários
A URL fornecida normalmente é uma URL virtual ou absoluta. Também pode ser uma URL que usa ASP.NET sintaxe relativa ao aplicativo, como "~/apprelativedirectory". A StaticSiteMapProvider classe normaliza automaticamente URLs brutas relativas ao aplicativo para um caminho virtual absoluto.
O XmlSiteMapProvider objeto, que é derivado do StaticSiteMapProvider provedor de mapa de site padrão para ASP.NET, usa a Url propriedade de um SiteMapNode objeto como uma chave de pesquisa em suas coleções internas, por padrão. Se a Url propriedade do SiteMapNode conjunto for definida, ela deverá ser exclusiva dentro do escopo do provedor de mapa do site. O FindSiteMapNode método tenta recuperar nós de mapa de site com base em seus Url. Caso contrário, você pode usar a Key propriedade e o método correspondente FindSiteMapNodeFromKey para recuperar nós de mapa do site. Se não for especificado ou Key nãoUrl, o provedor de mapa do site gerará automaticamente uma Key propriedade para acompanhar os nós do mapa do site.
Notas aos Herdeiros
Ao substituir o FindSiteMapNode(String) método em uma classe derivada, lembre-se de normalizar as URLs dos SiteMapNode objetos que você adiciona ao seu provedor de mapa de site, para que o FindSiteMapNode(String) método possa recuperar um nó de mapa de site, independentemente de a URL do nó do mapa do site ser fornecida como um caminho virtual absoluto ou um caminho relativo do aplicativo.
O comportamento de corte de segurança é incluído nas implementações de classe e StaticSiteMapProvider de SiteMapProvider classe. No entanto, para que o corte de segurança funcione em classes derivadas, você deve definir a propriedade de todos SiteMapNode os Roles objetos criados durante a criação de um provedor de mapa de site ao substituir o BuildSiteMap() método.
