XmlSiteMapProvider.FindSiteMapNodeFromKey(String) Método

Definición

Recupera un objeto SiteMapNode basándose en una clave especificada.

public:
 override System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);
public override System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
Public Overrides Function FindSiteMapNodeFromKey (key As String) As SiteMapNode

Parámetros

key
String

Clave de búsqueda con la que se va a buscar SiteMapNode.

Devoluciones

SiteMapNode

SiteMapNode que representa la página identificada por key; de lo contrario, es null si está habilitado el recorte de seguridad y el nodo no se puede mostrar al usuario actual o key no encuentra el nodo en la colección de nodos correspondiente.

Excepciones

Un proveedor secundario vinculado al proveedor del mapa del sitio actual ha devuelto un nodo que no es válido.

Comentarios

La clase invalida el método para asegurarse de que se busca en el nodo cualquier proveedor secundario vinculado, si la implementación de la clase base no devuelve XmlSiteMapProvider FindSiteMapNodeFromKey un nodo para key .

El objeto , derivado de la clase y el proveedor de mapa del sitio predeterminado para ASP.NET, usa la propiedad de un objeto como clave de búsqueda en sus XmlSiteMapProvider StaticSiteMapProvider Url SiteMapNode colecciones internas, de forma predeterminada. Si se Url establece la propiedad de , debe ser única dentro del ámbito del SiteMapNode proveedor. Si no Url se especifica ningún , genera automáticamente un para realizar un seguimiento de los XmlSiteMapProvider Key nodos.

El FindSiteMapNodeFromKey método puede llamar al método en cualquier proveedor secundario asociado al proveedor BuildSiteMap actual. Por lo tanto, es posible que se den las excepciones que se describen BuildSiteMap en el método .

Se aplica a

Consulte también