SiteMapProviderCollection Classe

Définition

Utilisé par la classe SiteMap pour suivre le jeu d'objets SiteMapProvider disponibles au SiteMap pendant l'initialisation du plan de site.Used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization. Cette classe ne peut pas être héritée.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
Héritage
SiteMapProviderCollection

Exemples

L’exemple de code suivant montre comment récupérer l' SiteMapProviderCollection objet à partir SiteMap de l’objet et comment effectuer une itération au sein de celui-ci.The following code example demonstrates how to retrieve the SiteMapProviderCollection object from the SiteMap object and iterate through it.

Si vous avez plus que le seul fournisseur par défaut configuré pour votre site, vous verrez chaque fournisseur affiché.If you have more than just the default provider configured for your site, you will see each provider that is displayed. Par exemple, si vous utilisez l’exemple AccessSiteMapProvider trouvé dans la vue d’ensemble de la SiteMapProvider classe, vous verrez la sortie suivante.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>

Remarques

La SiteMapProviderCollection classe est une collection fortement Hashtable typée SiteMapProvider d’objets.The SiteMapProviderCollection class is a strongly typed Hashtable collection of SiteMapProvider objects. Outre les deux méthodes Add, Add(ProviderBase) et Add(SiteMapProvider), la SiteMapProviderCollection classe prend en charge la AddArray méthode pour ajouter un tableau de type 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.

Est utilisé par la SiteMap classe pour effectuer le suivi de l' SiteMapProvider ensemble d’objets disponibles pour l' SiteMap initialisation du plan du site. SiteMapProviderCollectionThe SiteMapProviderCollection is used by the SiteMap class to track the set of SiteMapProvider objects that are available to the SiteMap during site map initialization. Toutefois, la présence d’un SiteMapProvider dans la collection de fournisseurs ne signifie pas nécessairement qu’il est utilisé SiteMap par un objet, mais uniquement qu’il est disponible pour utilisation.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.

Lorsqu’un SiteMapProvider est stocké dans SiteMapProviderCollectionle, Name la propriété est utilisée comme clé.When a SiteMapProvider is stored in the SiteMapProviderCollection, the Name property is used as the key.

Constructeurs

SiteMapProviderCollection()

Initialise une nouvelle instance de la classe SiteMapProviderCollection.Initializes a new instance of the SiteMapProviderCollection class.

Propriétés

Count

Obtient le nombre de fournisseurs contenus dans la collection.Gets the number of providers in the collection.

(Hérité de ProviderCollection)
IsSynchronized

Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).Gets a value indicating whether access to the collection is synchronized (thread safe).

(Hérité de ProviderCollection)
Item[String]

Obtient un objet SiteMapProvider avec un nom spécifique à partir de la collection de fournisseurs.Gets a SiteMapProvider object with a specific name from the provider collection.

SyncRoot

Obtient l'objet en cours.Gets the current object.

(Hérité de ProviderCollection)

Méthodes

Add(ProviderBase)

Ajoute un SiteMapProvider à la collection de fournisseurs à l'aide de la propriété Name utilisée en tant que clé.Adds a SiteMapProvider to the provider collection using the Name property as the key.

Add(SiteMapProvider)

Ajoute un objet SiteMapProvider à la collection de fournisseurs à l'aide de la propriété Name utilisée en tant que clé.Adds a SiteMapProvider object to the provider collection using the Name property as the key.

AddArray(SiteMapProvider[])

Ajoute un tableau d'objets SiteMapProvider dans la collection de fournisseurs à l'aide des propriétés Name en tant que clés.Adds an array of SiteMapProvider objects into the provider collection using the Name properties as keys.

Clear()

Supprime tous les éléments de la collection.Removes all items from the collection.

(Hérité de ProviderCollection)
CopyTo(ProviderBase[], Int32)

Copie le contenu de la collection dans le tableau donné en commençant à l'index spécifié.Copies the contents of the collection to the given array starting at the specified index.

(Hérité de ProviderCollection)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetEnumerator()

Retourne un objet qui implémente l'interface IEnumerator à itérer au sein de la collection.Returns an object that implements the IEnumerator interface to iterate through the collection.

(Hérité de ProviderCollection)
GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
Remove(String)

Supprime un fournisseur de la collection.Removes a provider from the collection.

(Hérité de ProviderCollection)
SetReadOnly()

Met la collection en lecture seule.Sets the collection to be read-only.

(Hérité de ProviderCollection)
ToString()

Retourne une chaîne qui représente l'objet en cours.Returns a string that represents the current object.

(Hérité de Object)

Implémentations d’interfaces explicites

ICollection.CopyTo(Array, Int32)

Copie les éléments d'ProviderCollection dans un tableau, en commençant au niveau d'un index de tableau particulier.Copies the elements of the ProviderCollection to an array, starting at a particular array index.

(Hérité de ProviderCollection)

Méthodes d’extension

Cast<TResult>(IEnumerable)

Effectue un cast des éléments d'un IEnumerable vers le type spécifié.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

S’applique à

Voir aussi