XmlSiteMapProvider.FindSiteMapNode(String) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

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

SiteMapNode que representa la página identificada por rawURL.

Excepciones

ProviderException

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 .

Consulte también

• GetRootNodeCore()
• BuildSiteMap()