SiteMapProviderCollection Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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(" ");
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(" ")
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. |