StaticSiteMapProvider.FindSiteMapNode(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recupera un objeto SiteMapNode que representa la página en la dirección 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
Dirección URL que identifica la página cuyo SiteMapNode se va a recuperar.
Devoluciones
SiteMapNode que representa la página identificada por rawURL; de lo contrario, es null si no se encuentra ningún nodo del mapa del sitio correspondiente.
Excepciones
rawURL es null.
Comentarios
La dirección URL proporcionada suele ser una dirección URL virtual o absoluta. También puede ser una dirección URL que usa ASP.NET sintaxis relativa a la aplicación, como "~/apprelativedirectory". La StaticSiteMapProvider clase normaliza automáticamente las direcciones URL sin procesar relativas a la aplicación en una ruta de acceso virtual absoluta.
El XmlSiteMapProvider objeto, que se deriva de StaticSiteMapProvider y es el proveedor de mapa de sitio predeterminado para ASP.NET, usa la Url propiedad de un SiteMapNode objeto como clave de búsqueda en sus colecciones internas, de forma predeterminada. Si se establece la Url propiedad de SiteMapNode , debe ser único dentro del ámbito del proveedor de mapa del sitio. El FindSiteMapNode método intenta recuperar nodos de mapa de sitio en función de su Url. De lo contrario, puede usar la Key propiedad y el método correspondiente FindSiteMapNodeFromKey para recuperar nodos de mapa del sitio. Si no Url se especifica o Key , el proveedor de mapa del sitio genera automáticamente una propiedad para realizar un Key seguimiento de los nodos del mapa del sitio.
Notas a los desarrolladores de herederos
Al invalidar el FindSiteMapNode(String) método en una clase derivada, asegúrese de normalizar las direcciones URL de los SiteMapNode objetos que agregue al proveedor de mapas de sitio para que el FindSiteMapNode(String) método pueda recuperar un nodo de mapa de sitio independientemente de si la dirección URL del nodo de mapa de sitio se proporciona como una ruta de acceso virtual absoluta o una ruta de acceso relativa a la aplicación.
El comportamiento de recorte de seguridad se incluye en las SiteMapProvider implementaciones de clase y StaticSiteMapProvider . Sin embargo, para el recorte de seguridad a la función en clases derivadas, debe establecer la Roles propiedad de los SiteMapNode objetos que cree al crear un proveedor de mapa de sitio al invalidar el BuildSiteMap() método .