SiteMapProviderCollection Clase

Referencia

Definición

Espacio de nombres:: System.Web

Ensamblado:: System.Web.dll

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: Object

ProviderCollection
SiteMapProviderCollection

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("&nbsp;&nbsp;&nbsp;");
        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("&nbsp;&nbsp;&nbsp;")
        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 SiteMapProvider SiteMapProviderCollection, 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.

Se aplica a