StaticSiteMapProvider.FindSiteMapNode(String) Método
Definição
Recupera um objeto SiteMapNode que representa a página na URL especificada.Retrieves a SiteMapNode object that represents the page at the specified URL.
public:
override System::Web::SiteMapNode ^ FindSiteMapNode(System::String ^ rawUrl);
public override System.Web.SiteMapNode FindSiteMapNode (string rawUrl);
override this.FindSiteMapNode : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode
Parâmetros
- rawUrl
- String
Uma URL que identifica a página para a qual um SiteMapNodeserá recuperado.A URL that identifies the page for which to retrieve a SiteMapNode.
Retornos
Um SiteMapNode que representa a página identificada pelo rawURL; caso contrário, null, se nenhum nó de mapa de site correspondente for encontrado.A SiteMapNode that represents the page identified by rawURL; otherwise, null, if no corresponding site map node is found.
Exceções
rawURL é null.rawURL is null.
Comentários
A URL fornecida normalmente é uma URL virtual ou absoluta.The provided URL is typically a virtual or absolute URL. Também pode ser uma URL que usa a sintaxe relativa ao aplicativo ASP.NET, como "~/apprelativedirectory" .It can also be a URL that uses ASP.NET application-relative syntax, such as "~/apprelativedirectory". A StaticSiteMapProvider classe normaliza automaticamente as URLs brutos relativas ao aplicativo para um caminho virtual absoluto.The StaticSiteMapProvider class automatically normalizes application-relative raw URLs to an absolute virtual path.
O XmlSiteMapProvider objeto, que é derivado de StaticSiteMapProvider e é o provedor de mapa do 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.The XmlSiteMapProvider object, which is derived from the StaticSiteMapProvider and is the default site map provider for ASP.NET, uses the Url property of a SiteMapNode object as a lookup key in its internal collections, by default. Se a Url propriedade de SiteMapNode for definida, ela deverá ser exclusiva dentro do escopo do provedor de mapa do site.If the Url property of the SiteMapNode is set, it must be unique within the scope of the site map provider. O FindSiteMapNode método tenta recuperar nós de mapa do site com base em seus Url .The FindSiteMapNode method attempts to retrieve site map nodes based on their Url. Caso contrário, você pode usar a Key propriedade e o FindSiteMapNodeFromKey método correspondente para recuperar nós do mapa do site.Otherwise, you can use the Key property and the corresponding FindSiteMapNodeFromKey method to retrieve site map nodes. Se não Url Key for ou for especificado, o provedor de mapa do site gerará automaticamente uma Key propriedade para controlar os nós do mapa do site.If no Url or Key is specified, the site map provider automatically generates a Key property to track the site map nodes.
Notas aos Herdeiros
Ao substituir o FindSiteMapNode(String) método em uma classe derivada, não se esqueça de normalizar as URLs dos SiteMapNode objetos que você adiciona ao seu provedor de mapa do site, para que o FindSiteMapNode(String) método possa recuperar um nó do mapa do site, independentemente de a URL do nó do mapa do site ser fornecida como um caminho virtual absoluto ou um caminho relativo do aplicativo.When overriding the FindSiteMapNode(String) method in a derived class, be sure to normalize the URLs of the SiteMapNode objects that you add to your site map provider, so that the FindSiteMapNode(String) method can retrieve a site map node regardless of whether URL for the site map node is supplied as an absolute virtual path or an application relative path.
O comportamento de aparamento de segurança está incluído nas SiteMapProvider StaticSiteMapProvider implementações de classe e.Security trimming behavior is included in the SiteMapProvider and StaticSiteMapProvider class implementations. No entanto, para que a remoção de segurança funcione em classes derivadas, você deve definir a Roles propriedade de todos os SiteMapNode objetos criados durante a criação de um provedor de mapa do site ao substituir o BuildSiteMap() método.However, for security trimming to function in derived classes, you must set the Roles property of any SiteMapNode objects that you create while building a site map provider when you override the BuildSiteMap() method.