StaticSiteMapProvider.FindSiteMapNodeFromKey(String) Método

Definición

Espacio de nombres:

System.Web

Ensamblado:

System.Web.dll

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 crea un SiteMapNode.

Devoluciones

SiteMapNode

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

Comentarios

El FindSiteMapNodeFromKey método recupera un nodo de mapa de sitio de un objeto interno Hashtable basado en key.

El XmlSiteMapProvider objeto, que se deriva de la StaticSiteMapProvider clase 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.

StaticSiteMapProvider tiene una implementación predeterminada que busca instancias de la SiteMapNode clase en función del key parámetro . Si un implementador de proveedor de mapa de sitio usó el AddNode método , StaticSiteMapProvider ya habrá almacenado una referencia a cada SiteMapNode uno en función del valor de la SiteMapNode.Key propiedad . De forma predeterminada, genera XmlSiteMapProvider GUID para instancias de la SiteMapNode clase que no tienen un valor para la SiteMapNode.Url propiedad . Los implementadores personalizados del proveedor de mapa de sitio deben proporcionar su propio mecanismo para generar valores únicos de la SiteMapNode.Key propiedad en caso de que una instancia de la SiteMapNode clase no tenga un valor para la SiteMapNode.Url propiedad .

Las SiteMapProvider clases yXmlSiteMapProvider, que son la implementación predeterminada del proveedor de mapa de sitio para ASP.NET, usan la dirección URL de un SiteMapNode objeto como clave en las distintas colecciones que mantienen las clases.

Consulte también

• FindSiteMapNode