SiteMapProviderCollection Classe

Definizione

Usata dalla classe SiteMap per tenere traccia di un insieme di oggetti SiteMapProvider disponibili per l'elemento SiteMap durante l'inizializzazione della mappa del sito.Used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization. Questa classe non può essere ereditata.This class cannot be inherited.

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
Ereditarietà
SiteMapProviderCollection

Esempi

Nell'esempio di codice seguente viene illustrato come recuperare SiteMapProviderCollection l'oggetto SiteMap dall'oggetto e scorrerlo.The following code example demonstrates how to retrieve the SiteMapProviderCollection object from the SiteMap object and iterate through it.

Se si dispone di più del provider predefinito configurato per il sito, verrà visualizzato ogni provider visualizzato.If you have more than just the default provider configured for your site, you will see each provider that is displayed. Se ad esempio si usa l'esempio AccessSiteMapProvider disponibile SiteMapProvider nella panoramica della classe, verrà visualizzato il seguente output.For example, if you are using the sample AccessSiteMapProvider found in the SiteMapProvider class overview, you will see the following output.

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>

Commenti

La SiteMapProviderCollection classe è una raccolta fortemente Hashtable tipizzata SiteMapProvider di oggetti.The SiteMapProviderCollection class is a strongly typed Hashtable collection of SiteMapProvider objects. Oltre ai due metodi Add, Add(ProviderBase) e Add(SiteMapProvider), la SiteMapProviderCollection classe supporta il AddArray metodo per aggiungere una matrice di tipo SiteMapProvider.In addition to the two add methods, Add(ProviderBase) and Add(SiteMapProvider), the SiteMapProviderCollection class supports the AddArray method to add an array of type SiteMapProvider.

L' SiteMapProviderCollection oggetto viene utilizzato SiteMap dalla classe per tenere traccia del set SiteMapProvider di oggetti disponibili per l'oggetto SiteMap durante l'inizializzazione della mappa del sito.The SiteMapProviderCollection is used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization. Tuttavia, la presenza di un SiteMapProvider oggetto nella raccolta del provider non significa necessariamente che sia utilizzata da un SiteMap oggetto, ma solo che sia disponibile per l'utilizzo.However, the presence of a SiteMapProvider in the provider collection does not necessarily mean it is used by a SiteMap object, only that it is available for use.

Quando un SiteMapProvider oggetto viene archiviato SiteMapProviderCollectionin, la Name proprietà viene utilizzata come chiave.When a SiteMapProvider is stored in the SiteMapProviderCollection, the Name property is used as the key.

Costruttori

SiteMapProviderCollection()

Inizializza una nuova istanza della classe SiteMapProviderCollection.Initializes a new instance of the SiteMapProviderCollection class.

Proprietà

Count

Ottiene il numero di provider presenti nell'insieme.Gets the number of providers in the collection.

(Ereditato da ProviderCollection)
IsSynchronized

Ottiene un valore che indica se l'accesso alla raccolta è sincronizzato (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread safe).

(Ereditato da ProviderCollection)
Item[String]

Ottiene un oggetto SiteMapProvider con un nome specifico dalla raccolta di provider.Gets a SiteMapProvider object with a specific name from the provider collection.

SyncRoot

Ottiene l'oggetto corrente.Gets the current object.

(Ereditato da ProviderCollection)

Metodi

Add(ProviderBase)

Aggiunge un elemento SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.Adds a SiteMapProvider to the provider collection using the Name property as the key.

Add(SiteMapProvider)

Aggiunge un oggetto SiteMapProvider alla raccolta di provider usando la proprietà Name come chiave.Adds a SiteMapProvider object to the provider collection using the Name property as the key.

AddArray(SiteMapProvider[])

Aggiunge una matrice di oggetti SiteMapProvider alla raccolta di provider usando le proprietà Name come chiavi.Adds an array of SiteMapProvider objects into the provider collection using the Name properties as keys.

Clear()

Rimuove tutti gli elementi dalla raccolta.Removes all items from the collection.

(Ereditato da ProviderCollection)
CopyTo(ProviderBase[], Int32)

Copia il contenuto dell'insieme nella matrice indicata a partire dall'indice specificato.Copies the contents of the collection to the given array starting at the specified index.

(Ereditato da ProviderCollection)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetEnumerator()

Restituisce un oggetto che implementa l'interfaccia IEnumerator per scorrere l'insieme.Returns an object that implements the IEnumerator interface to iterate through the collection.

(Ereditato da ProviderCollection)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
Remove(String)

Rimuove un provider dall'insieme.Removes a provider from the collection.

(Ereditato da ProviderCollection)
SetReadOnly()

Imposta l'insieme come oggetto in sola lettura.Sets the collection to be read-only.

(Ereditato da ProviderCollection)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ICollection.CopyTo(Array, Int32)

Copia gli elementi dell'oggetto ProviderCollection in una matrice, iniziando in corrispondenza di un particolare indice di matrice.Copies the elements of the ProviderCollection to an array, starting at a particular array index.

(Ereditato da ProviderCollection)

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche