SiteMapProvider.FindSiteMapNodeFromKey(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 basándose en una clave especificada.
public:
virtual System::Web::SiteMapNode ^ FindSiteMapNodeFromKey(System::String ^ key);public virtual System.Web.SiteMapNode FindSiteMapNodeFromKey (string key);abstract member FindSiteMapNodeFromKey : string -> System.Web.SiteMapNode
override this.FindSiteMapNodeFromKey : string -> System.Web.SiteMapNodePublic Overridable Function FindSiteMapNodeFromKey (key As String) As SiteMapNodeParámetros
- key
- String
Clave de búsqueda con la que se crea un SiteMapNode.
Devoluciones
Es un SiteMapNode que representa la página identificada mediante la key; de lo contrario, es null si no se encuentra ningún SiteMapNode correspondiente o si está habilitado el recorte de seguridad y no se puede devolver el SiteMapNode para el usuario actual. De manera predeterminada, es null.
Comentarios
La SiteMapProvider implementación devuelve null en todos los casos. Las clases que derivan de la SiteMapProvider clase pueden invalidar el FindSiteMapNodeFromKey método para proporcionar funcionalidad de búsqueda basada en una clave única (en lugar de una dirección URL, que usa el FindSiteMapNode método ). Implemente el método si la FindSiteMapNodeFromKey implementación del proveedor de mapas de sitio usa la SiteMapNode.Key propiedad de un SiteMapNode objeto como identificador principal en una estructura de mapa de sitio.
La StaticSiteMapProvider clase proporciona una implementación que controla la búsqueda de nodos de mapa de sitio que no definen una dirección URL.
La XmlSiteMapProvider clase , que es el proveedor de mapa de sitio predeterminado para ASP.NET, usa la dirección URL de como SiteMapNode clave en las distintas colecciones que mantienen las clases. Por lo tanto, si un nodo proporciona una dirección URL, debe ser único dentro del ámbito del proveedor de mapa del sitio. Si no se proporciona ninguna dirección URL, se genera un identificador único para identificar .SiteMapNode