XmlSiteMapProvider.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.SiteMapNode
Public Overrides Function FindSiteMapNode (rawUrl As String) As SiteMapNode
Pará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
.
Excepciones
Un proveedor secundario vinculado al proveedor del mapa del sitio actual ha devuelto un nodo que no es válido.
Comentarios
El XmlSiteMapProvider objeto invalida el FindSiteMapNode método para asegurarse de que los proveedores secundarios vinculados se buscan en el nodo si la implementación de la clase base no devuelve un nodo para la dirección URL especificada.
El rawUrl
parámetro debe ser una ruta de acceso virtual absoluta o una ruta de acceso relativa a la aplicación, en función de cómo se especifique en el archivo de datos del mapa del sitio XML.
La XmlSiteMapProvider clase y las clases que se derivan de ella usan la dirección URL de un SiteMapNode objeto como clave en las distintas colecciones que mantiene la clase. Por lo tanto, estas direcciones URL deben ser únicas dentro del ámbito del mapa del sitio. Si la dirección URL no se encuentra dentro de los datos inmediatos del mapa del sitio administrados por XmlSiteMapProvider, llama a en FindSiteMapNode cada proveedor secundario que esté vinculado a él a través del provider
atributo de sus nodos de mapa de sitio.
El FindSiteMapNode método llama indirectamente al BuildSiteMap método para recuperar el nodo de nivel superior en el mapa del sitio. Por lo tanto, las excepciones que se producen para el BuildSiteMap método también se pueden producir al llamar al FindSiteMapNode método .