SiteMapProviderCollection Clase
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í.
La clase SiteMap la utiliza para realizar el seguimiento del conjunto de objetos SiteMapProvider que están disponibles para SiteMap durante la inicialización del mapa del sitio. Esta clase no puede heredarse.
public ref class SiteMapProviderCollection sealed : System::Configuration::Provider::ProviderCollection
public sealed class SiteMapProviderCollection : System.Configuration.Provider.ProviderCollection
type SiteMapProviderCollection = class
inherit ProviderCollection
Public NotInheritable Class SiteMapProviderCollection
Inherits ProviderCollection
- Herencia
Ejemplos
En el ejemplo de código siguiente se muestra cómo recuperar el SiteMapProviderCollection objeto del SiteMap objeto y recorrerlo en iteración.
Si tiene más que el proveedor predeterminado configurado para el sitio, verá cada proveedor que se muestra. Por ejemplo, si usa el ejemplo AccessSiteMapProvider
que se encuentra en la información general de la SiteMapProvider clase, verá la salida siguiente.
XmlSiteMapProvider System.Web.XmlSiteMapProvider
AccessSiteMapProvider Samples.AspNet.Controls.AccessSiteMapProvider
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<SCRIPT runat="server">
private void Page_Load(object sender, System.EventArgs e)
{
// Navigate the SiteMap built by the default SiteMapProvider.
Response.Write(SiteMap.RootNode.ToString() + "<BR>");
Response.Write(SiteMap.RootNode.Url + "<BR>");
Response.Write(SiteMap.RootNode.Title + "<BR>");
foreach (SiteMapNode sitemapnode in SiteMap.RootNode.ChildNodes)
{
// Iterate through the ChildNodes SiteMapNodesCollection
// maintained by the RootNode.
Response.Write(sitemapnode.Url + "<BR>" );
}
IEnumerator providers = SiteMap.Providers.GetEnumerator();
while (providers.MoveNext())
{
Response.Write(providers.Current);
Response.Write(" ");
Response.Write("<BR>");
}
}
</SCRIPT>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<SCRIPT runat="server">
Private Sub Page_Load(Sender As Object, E As EventArgs)
' Navigate the SiteMap built by the default SiteMapProvider.
Response.Write(SiteMap.RootNode.ToString() & "<BR>")
Response.Write(SiteMap.RootNode.Url & "<BR>")
Response.Write(SiteMap.RootNode.Title & "<BR>")
Dim sitemapnode As SiteMapNode
For Each sitemapnode In SiteMap.RootNode.ChildNodes
' Iterate through the ChildNodes SiteMapNodesCollection
' maintained by the RootNode.
Response.Write(sitemapnode.Url & "<BR>" )
Next
Dim providers As IDictionaryEnumerator = SiteMap.Providers.GetEnumerator()
While (providers.MoveNext())
Response.Write(providers.Current)
Response.Write(" ")
Response.Write("<BR>")
End While
End Sub ' Page_Load
</SCRIPT>
Comentarios
La SiteMapProviderCollection clase es una colección fuertemente tipada Hashtable de SiteMapProvider objetos. Además de los dos métodos add, Add(ProviderBase) y Add(SiteMapProvider), la SiteMapProviderCollection clase admite el AddArray método para agregar una matriz de tipo SiteMapProvider.
La SiteMapProviderCollection clase usa SiteMap para realizar un seguimiento del conjunto de SiteMapProvider objetos que están disponibles para durante la SiteMap inicialización del mapa del sitio. Sin embargo, la presencia de un SiteMapProvider elemento en la colección de proveedores no significa necesariamente que un objeto lo use SiteMap , solo que está disponible para su uso.
Cuando se almacena en SiteMapProviderSiteMapProviderCollection, la Name propiedad se usa como clave.
Constructores
SiteMapProviderCollection() |
Inicializa una nueva instancia de la clase SiteMapProviderCollection. |
Propiedades
Count |
Obtiene el número de proveedores que hay en la colección. (Heredado de ProviderCollection) |
IsSynchronized |
Obtiene un valor que indica si el acceso a la colección está sincronizado (es seguro para la ejecución de subprocesos). (Heredado de ProviderCollection) |
Item[String] |
Obtiene un objeto SiteMapProvider con un nombre específico de la colección de proveedores. |
SyncRoot |
Obtiene el objeto actual. (Heredado de ProviderCollection) |
Métodos
Add(ProviderBase) |
Agrega un SiteMapProvider a la colección de proveedores utilizando la propiedad Name como clave. |
Add(SiteMapProvider) |
Agrega un objeto SiteMapProvider a la colección de proveedores utilizando la propiedad Name como clave. |
AddArray(SiteMapProvider[]) |
Agrega una matriz de objetos SiteMapProvider a la colección de proveedores utilizando las propiedades Name como claves. |
Clear() |
Quita todos los elementos de la colección. (Heredado de ProviderCollection) |
CopyTo(ProviderBase[], Int32) |
Copia el contenido de la colección en la matriz determinada, comenzando por el índice especificado. (Heredado de ProviderCollection) |
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetEnumerator() |
Devuelve un objeto que implementa la interfaz IEnumerator para recorrer en iteración la colección. (Heredado de ProviderCollection) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
Remove(String) |
Quita un proveedor de la colección. (Heredado de ProviderCollection) |
SetReadOnly() |
Establece la colección para que sea de sólo lectura. (Heredado de ProviderCollection) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |
Implementaciones de interfaz explícitas
ICollection.CopyTo(Array, Int32) |
Copia los elementos de ProviderCollection en una matriz, comenzando en un índice concreto de la matriz. (Heredado de ProviderCollection) |
Métodos de extensión
Cast<TResult>(IEnumerable) |
Convierte los elementos de IEnumerable en el tipo especificado. |
OfType<TResult>(IEnumerable) |
Filtra los elementos de IEnumerable en función de un tipo especificado. |
AsParallel(IEnumerable) |
Habilita la paralelización de una consulta. |
AsQueryable(IEnumerable) |
Convierte una interfaz IEnumerable en IQueryable. |