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. Cette classe ne peut pas être héritée.

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’objet SiteMapProviderCollection à partir de l’objet SiteMap et l’itérer.

Si vous avez plus que le fournisseur par défaut configuré pour votre site, vous verrez chaque fournisseur affiché. Par exemple, si vous utilisez l’exemple AccessSiteMapProvider trouvé dans la vue d’ensemble de la SiteMapProvider classe, vous verrez la sortie suivante.

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 typée Hashtable d’objets SiteMapProvider . Outre les deux méthodes d’ajout, Add(ProviderBase) et Add(SiteMapProvider), la SiteMapProviderCollection classe prend en charge la AddArray méthode pour ajouter un tableau de type SiteMapProvider.

Il SiteMapProviderCollection est utilisé par la SiteMap classe pour suivre l’ensemble d’objets disponibles lors de l’initialisation SiteMap de la carte de SiteMapProvider site. Toutefois, la présence d’une SiteMapProvider collection de fournisseurs ne signifie pas nécessairement qu’elle est utilisée par un SiteMap objet, uniquement qu’elle est disponible pour une utilisation.

Lorsqu’un SiteMapProvider est stocké dans le SiteMapProviderCollection, la Name propriété est utilisée comme clé.

Constructeurs

SiteMapProviderCollection()

Initialise une nouvelle instance de la classe SiteMapProviderCollection.

Propriétés

Count

Obtient le nombre de fournisseurs contenus dans la collection.

(Hérité de ProviderCollection)
IsSynchronized

Obtient une valeur indiquant si l’accès à la collection est synchronisé (thread-safe).

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

Obtient un objet SiteMapProvider avec un nom spécifique à partir de la collection de fournisseurs.

SyncRoot

Obtient l'objet en cours.

(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é.

Add(SiteMapProvider)

Ajoute un objet SiteMapProvider à la collection de fournisseurs à l'aide de la propriété Name utilisée en tant que clé.

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.

Clear()

Supprime tous les éléments de la 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é.

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

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
GetEnumerator()

Retourne un objet qui implémente l'interface IEnumerator à itérer au sein de la collection.

(Hérité de ProviderCollection)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

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

Supprime un fournisseur de la collection.

(Hérité de ProviderCollection)
SetReadOnly()

Met la collection en lecture seule.

(Hérité de ProviderCollection)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(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.

(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é.

OfType<TResult>(IEnumerable)

Filtre les éléments d'un IEnumerable en fonction du type spécifié.

AsParallel(IEnumerable)

Active la parallélisation d'une requête.

AsQueryable(IEnumerable)

Convertit un IEnumerable en IQueryable.

S’applique à

Voir aussi