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 y effectuer une itération.

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 d’objets SiteMapProvider fortement typésHashtable. En plus des deux méthodes add, et , la classe prend en charge la AddArray méthode pour ajouter un tableau de type SiteMapProvider.SiteMapProviderCollectionAdd(ProviderBase)Add(SiteMapProvider)

est SiteMapProviderCollection utilisé par la SiteMap classe pour suivre l’ensemble d’objets SiteMapProvider qui sont disponibles pour le pendant l’initialisation de la SiteMap carte de site. Toutefois, la présence d’un SiteMapProvider dans la collection de fournisseurs ne signifie pas nécessairement qu’il est utilisé par un SiteMap objet, mais seulement qu’il est disponible pour utilisation.

Lorsqu’un SiteMapProvider est stocké dans , SiteMapProviderCollectionla 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