RootProfilePropertySettingsCollection Classe

Définition

Espace de noms:

System.Web.Configuration

Assembly:

System.Web.dll

Agit en haut d’une hiérarchie nommée à deux niveaux de ProfilePropertySettingsCollection collections.

public ref class RootProfilePropertySettingsCollection sealed : System::Web::Configuration::ProfilePropertySettingsCollection

[System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ProfilePropertySettings))]
public sealed class RootProfilePropertySettingsCollection : System.Web.Configuration.ProfilePropertySettingsCollection

[<System.Configuration.ConfigurationCollection(typeof(System.Web.Configuration.ProfilePropertySettings))>]
type RootProfilePropertySettingsCollection = class
    inherit ProfilePropertySettingsCollection

Public NotInheritable Class RootProfilePropertySettingsCollection
Inherits ProfilePropertySettingsCollection

Héritage

Object

ConfigurationElement

ConfigurationElementCollection

ProfilePropertySettingsCollection

RootProfilePropertySettingsCollection

Attributs

ConfigurationCollectionAttribute

Exemples

L’exemple de code suivant montre comment utiliser le RootProfilePropertySettingsCollection type comme PropertySettings propriété de la ProfileSection classe. Cet exemple de code fait partie d’un exemple plus grand fourni pour la ProfileSection classe.

// Display all current root ProfilePropertySettings.
Console.WriteLine("Current Root ProfilePropertySettings:");
int rootPPSCtr = 0;
foreach (ProfilePropertySettings rootPPS in profileSection.PropertySettings)
{
    Console.WriteLine("  {0}: ProfilePropertySetting '{1}'", ++rootPPSCtr,
        rootPPS.Name);
}

// Get and modify a root ProfilePropertySettings object.
Console.WriteLine(
    "Display and modify 'LastReadDate' ProfilePropertySettings:");
ProfilePropertySettings profilePropertySettings =
    profileSection.PropertySettings["LastReadDate"];

// Get the current ReadOnly property value.
Console.WriteLine(
    "Current ReadOnly value: '{0}'", profilePropertySettings.ReadOnly);

// Set the ReadOnly property to true.
profilePropertySettings.ReadOnly = true;

// Get the current AllowAnonymous property value.
Console.WriteLine(
    "Current AllowAnonymous value: '{0}'", profilePropertySettings.AllowAnonymous);

// Set the AllowAnonymous property to true.
profilePropertySettings.AllowAnonymous = true;

// Get the current SerializeAs property value.
Console.WriteLine(
    "Current SerializeAs value: '{0}'", profilePropertySettings.SerializeAs);

// Set the SerializeAs property to SerializationMode.Binary.
profilePropertySettings.SerializeAs = SerializationMode.Binary;

// Get the current Type property value.
Console.WriteLine(
    "Current Type value: '{0}'", profilePropertySettings.Type);

// Set the Type property to "System.DateTime".
profilePropertySettings.Type = "System.DateTime";

// Get the current DefaultValue property value.
Console.WriteLine(
    "Current DefaultValue value: '{0}'", profilePropertySettings.DefaultValue);

// Set the DefaultValue property to "March 16, 2004".
profilePropertySettings.DefaultValue = "March 16, 2004";

// Get the current ProviderName property value.
Console.WriteLine(
    "Current ProviderName value: '{0}'", profilePropertySettings.Provider);

// Set the ProviderName property to "AspNetSqlRoleProvider".
profilePropertySettings.Provider = "AspNetSqlRoleProvider";

// Get the current Name property value.
Console.WriteLine(
    "Current Name value: '{0}'", profilePropertySettings.Name);

// Set the Name property to "LastAccessDate".
profilePropertySettings.Name = "LastAccessDate";

// Display all current ProfileGroupSettings.
Console.WriteLine("Current ProfileGroupSettings:");
int PGSCtr = 0;
foreach (ProfileGroupSettings propGroups in profileSection.PropertySettings.GroupSettings)
{
    Console.WriteLine("  {0}: ProfileGroupSetting '{1}'", ++PGSCtr,
        propGroups.Name);
    int PPSCtr = 0;
    foreach (ProfilePropertySettings props in propGroups.PropertySettings)
    {
        Console.WriteLine("    {0}: ProfilePropertySetting '{1}'", ++PPSCtr,
            props.Name);
    }
}

// Add a new group.
ProfileGroupSettings newPropGroup = new ProfileGroupSettings("Forum");
profileSection.PropertySettings.GroupSettings.Add(newPropGroup);

// Add a new PropertySettings to the group.
ProfilePropertySettings newProp = new ProfilePropertySettings("AvatarImage");
newProp.Type = "System.String, System.dll";
newPropGroup.PropertySettings.Add(newProp);

// Remove a PropertySettings from the group.
newPropGroup.PropertySettings.Remove("AvatarImage");
newPropGroup.PropertySettings.RemoveAt(0);

// Clear all PropertySettings from the group.
newPropGroup.PropertySettings.Clear();

' Display all current root ProfilePropertySettings.
Console.WriteLine("Current Root ProfilePropertySettings:")
Dim rootPPSCtr As Integer = 0
For Each rootPPS As ProfilePropertySettings In profileSection.PropertySettings
    Console.WriteLine("  {0}: ProfilePropertySetting '{1}'", ++rootPPSCtr, _
        rootPPS.Name)
Next

' Get and modify a root ProfilePropertySettings object.
Console.WriteLine( _
    "Display and modify 'LastReadDate' ProfilePropertySettings:")
Dim profilePropertySettings As ProfilePropertySettings = _
    profileSection.PropertySettings("LastReadDate")

' Get the current ReadOnly property value.
Console.WriteLine( _
    "Current ReadOnly value: '{0}'", profilePropertySettings.ReadOnly)

' Set the ReadOnly property to true.
profilePropertySettings.ReadOnly = true

' Get the current AllowAnonymous property value.
Console.WriteLine( _
    "Current AllowAnonymous value: '{0}'", profilePropertySettings.AllowAnonymous)

' Set the AllowAnonymous property to true.
profilePropertySettings.AllowAnonymous = true

' Get the current SerializeAs property value.
Console.WriteLine( _
    "Current SerializeAs value: '{0}'", profilePropertySettings.SerializeAs)

' Set the SerializeAs property to SerializationMode.Binary.
profilePropertySettings.SerializeAs = SerializationMode.Binary

' Get the current Type property value.
Console.WriteLine( _
    "Current Type value: '{0}'", profilePropertySettings.Type)

' Set the Type property to "System.DateTime".
profilePropertySettings.Type = "System.DateTime"

' Get the current DefaultValue property value.
Console.WriteLine( _
    "Current DefaultValue value: '{0}'", profilePropertySettings.DefaultValue)

' Set the DefaultValue property to "March 16, 2004".
profilePropertySettings.DefaultValue = "March 16, 2004"

' Get the current ProviderName property value.
            Console.WriteLine( _
                "Current ProviderName value: '{0}'", profilePropertySettings.Provider)

' Set the ProviderName property to "AspNetSqlRoleProvider".
            profilePropertySettings.Provider = "AspNetSqlRoleProvider"

' Get the current Name property value.
Console.WriteLine( _
    "Current Name value: '{0}'", profilePropertySettings.Name)

' Set the Name property to "LastAccessDate".
profilePropertySettings.Name = "LastAccessDate"

' Display all current ProfileGroupSettings.
Console.WriteLine("Current ProfileGroupSettings:")
Dim PGSCtr As Integer = 0
For Each propGroups As ProfileGroupSettings In profileSection.PropertySettings.GroupSettings
                    Console.WriteLine("  {0}: ProfileGroupSettings '{1}'", ++PGSCtr, _
        propGroups.Name)
    Dim PPSCtr As Integer = 0
    For Each props As ProfilePropertySettings In propGroups.PropertySettings
        Console.WriteLine("    {0}: ProfilePropertySetting '{1}'", ++PPSCtr, _
            props.Name)
    Next
Next

' Add a new group.
Dim newPropGroup As ProfileGroupSettings = new ProfileGroupSettings("Forum")
profileSection.PropertySettings.GroupSettings.Add(newPropGroup)

' Add a new PropertySettings to the group.
Dim newProp As ProfilePropertySettings = new ProfilePropertySettings("AvatarImage")
newProp.Type = "System.String, System.dll"
newPropGroup.PropertySettings.Add(newProp)

' Remove a PropertySettings from the group.
newPropGroup.PropertySettings.Remove("AvatarImage")
newPropGroup.PropertySettings.RemoveAt(0)

' Clear all PropertySettings from the group.
newPropGroup.PropertySettings.Clear()

Remarques

La RootProfilePropertySettingsCollection classe est à la fois une collection de niveau ProfilePropertySettingsCollection racine et un conteneur pour une ProfileGroupSettingsCollection collection. Ces collections vous permettent de créer des groupes nommés d’autres ProfilePropertySettingsCollection collections, chacun contenant des objets nommés ProfilePropertySettings individuels. Pour plus d’informations sur les fonctionnalités de profil ajoutées à ASP.NET 2.0, consultez ASP.NET Propriétés du profil.

La PropertySettings propriété est un RootProfilePropertySettingsCollection objet qui contient toutes les propriétés définies dans la properties sous-section de la profile section du fichier de configuration.

Constructeurs

Nom	Description
RootProfilePropertySettingsCollection()	Initialise une nouvelle instance de la classe à l’aide RootProfilePropertySettingsCollection des paramètres par défaut.

Propriétés

Nom	Description
AddElementName	Obtient ou définit le nom de l’association ConfigurationElement à l’opération d’ajout dans la ConfigurationElementCollection classe dérivée en cas de substitution. (Hérité de ConfigurationElementCollection)
AllKeys	Retourne un tableau contenant les noms de tous les ProfileSection objets contenus dans la collection. (Hérité de ProfilePropertySettingsCollection)
AllowClear	Obtient une valeur indiquant si l’élément <clear> est valide en tant qu’objet ProfilePropertySettings . (Hérité de ProfilePropertySettingsCollection)
ClearElementName	Obtient ou définit le nom de l’association ConfigurationElement à l’opération clear dans la ConfigurationElementCollection classe dérivée en cas de substitution. (Hérité de ConfigurationElementCollection)
CollectionType	Obtient le type du ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
Count	Obtient le nombre d’éléments de la collection. (Hérité de ConfigurationElementCollection)
CurrentConfiguration	Obtient une référence à l’instance de niveau Configuration supérieur qui représente la hiérarchie de configuration à laquelle appartient l’instance actuelle ConfigurationElement . (Hérité de ConfigurationElement)
ElementInformation	Obtient un ElementInformation objet qui contient les informations et fonctionnalités non personnalisables de l’objet ConfigurationElement . (Hérité de ConfigurationElement)
ElementName	Obtient le nom utilisé pour identifier cette collection d’éléments dans le fichier de configuration en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
ElementProperty	Obtient l’objet ConfigurationElementProperty qui représente l’objet ConfigurationElement lui-même. (Hérité de ConfigurationElement)
EmitClear	Obtient ou définit une valeur qui spécifie si la collection a été effacée. (Hérité de ConfigurationElementCollection)
EvaluationContext	Obtient l'objet ContextInformation pour l'objet ConfigurationElement. (Hérité de ConfigurationElement)
GroupSettings	Obtient une ProfileGroupSettingsCollection collection d’objets ProfileGroupSettings contenant.
HasContext	Obtient une valeur qui indique si la CurrentConfiguration propriété est null. (Hérité de ConfigurationElement)
IsSynchronized	Obtient une valeur indiquant si l’accès à la collection est synchronisé. (Hérité de ConfigurationElementCollection)
Item[ConfigurationProperty]	Obtient ou définit une propriété ou un attribut de cet élément de configuration. (Hérité de ConfigurationElement)
Item[Int32]	Obtient ou définit l’objet ProfilePropertySettings à l’emplacement d’index spécifié. (Hérité de ProfilePropertySettingsCollection)
Item[String]	Obtient ou définit l’objet ProfilePropertySettings avec le nom spécifié. (Hérité de ProfilePropertySettingsCollection)
LockAllAttributesExcept	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockAllElementsExcept	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockAttributes	Obtient la collection d’attributs verrouillés. (Hérité de ConfigurationElement)
LockElements	Obtient la collection d’éléments verrouillés. (Hérité de ConfigurationElement)
LockItem	Obtient ou définit une valeur indiquant si l’élément est verrouillé. (Hérité de ConfigurationElement)
Properties	Obtient une collection de propriétés de configuration. (Hérité de ProfilePropertySettingsCollection)
RemoveElementName	Obtient ou définit le nom de l’association ConfigurationElement à l’opération de suppression dans la ConfigurationElementCollection classe dérivée en cas de substitution. (Hérité de ConfigurationElementCollection)
SyncRoot	Obtient un objet utilisé pour synchroniser l’accès ConfigurationElementCollectionau . (Hérité de ConfigurationElementCollection)
ThrowOnDuplicate	Obtient une valeur indiquant si une erreur doit être levée si une tentative de création d’un objet en double est effectuée. (Hérité de ProfilePropertySettingsCollection)

Méthodes

Nom	Description
Add(ProfilePropertySettings)	Ajoute un ProfilePropertySettings objet à la collection. (Hérité de ProfilePropertySettingsCollection)
BaseAdd(ConfigurationElement, Boolean)	Ajoute un élément de configuration à la collection d’éléments de configuration. (Hérité de ConfigurationElementCollection)
BaseAdd(ConfigurationElement)	Ajoute un élément de configuration au ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
BaseAdd(Int32, ConfigurationElement)	Ajoute un élément de configuration à la collection d’éléments de configuration. (Hérité de ConfigurationElementCollection)
BaseClear()	Supprime tous les objets d’élément de configuration de la collection. (Hérité de ConfigurationElementCollection)
BaseGet(Int32)	Obtient l’élément de configuration à l’emplacement d’index spécifié. (Hérité de ConfigurationElementCollection)
BaseGet(Object)	Retourne l’élément de configuration avec la clé spécifiée. (Hérité de ConfigurationElementCollection)
BaseGetAllKeys()	Retourne un tableau des clés pour tous les éléments de configuration contenus dans le ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
BaseGetKey(Int32)	Obtient la clé de l’emplacement ConfigurationElement d’index spécifié. (Hérité de ConfigurationElementCollection)
BaseIndexOf(ConfigurationElement)	Indique l’index du fichier spécifié ConfigurationElement. (Hérité de ConfigurationElementCollection)
BaseIsRemoved(Object)	Indique si la ConfigurationElement clé spécifiée a été supprimée du ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
BaseRemove(Object)	Supprime une ConfigurationElement de la collection. (Hérité de ConfigurationElementCollection)
BaseRemoveAt(Int32)	Supprime l’emplacement ConfigurationElement d’index spécifié. (Hérité de ConfigurationElementCollection)
Clear()	Supprime tous les ProfilePropertySettings objets de la collection. (Hérité de ProfilePropertySettingsCollection)
CopyTo(ConfigurationElement[], Int32)	Copie le contenu du ConfigurationElementCollection tableau. (Hérité de ConfigurationElementCollection)
CreateNewElement()	En cas de substitution dans une classe dérivée, crée un nouveau ConfigurationElement. (Hérité de ProfilePropertySettingsCollection)
CreateNewElement(String)	Crée un nouveau ConfigurationElement en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
DeserializeElement(XmlReader, Boolean)	Lit le code XML à partir du fichier de configuration. (Hérité de ConfigurationElement)
Equals(Object)	Compare l’objet actuel RootProfilePropertySettingsCollection à un autre objet A RootProfilePropertySettingsCollection .
Get(Int32)	Retourne l’objet ProfileSection à l’index spécifié. (Hérité de ProfilePropertySettingsCollection)
Get(String)	Retourne l’objet ProfileSection portant le nom spécifié. (Hérité de ProfilePropertySettingsCollection)
GetElementKey(ConfigurationElement)	Obtient la clé de l’élément de configuration spécifié. (Hérité de ProfilePropertySettingsCollection)
GetEnumerator()	Obtient un IEnumerator qui est utilisé pour itérer à travers le ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
GetHashCode()	Génère un code de hachage pour la collection.
GetKey(Int32)	Obtient le nom de l’emplacement ProfilePropertySettings d’index spécifié. (Hérité de ProfilePropertySettingsCollection)
GetTransformedAssemblyString(String)	Retourne la version transformée du nom d’assembly spécifié. (Hérité de ConfigurationElement)
GetTransformedTypeString(String)	Retourne la version transformée du nom de type spécifié. (Hérité de ConfigurationElement)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
IndexOf(ProfilePropertySettings)	Retourne l’index de l’objet spécifié ProfilePropertySettings . (Hérité de ProfilePropertySettingsCollection)
Init()	Définit l’objet ConfigurationElement à son état initial. (Hérité de ConfigurationElement)
InitializeDefault()	Permet d’initialiser un jeu de valeurs par défaut pour l’objet ConfigurationElement . (Hérité de ConfigurationElement)
IsElementName(String)	Indique si le paramètre spécifié ConfigurationElement existe dans le ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
IsElementRemovable(ConfigurationElement)	Indique si le spécifié ConfigurationElement peut être supprimé du ConfigurationElementCollection. (Hérité de ConfigurationElementCollection)
IsModified()	Indique si cette ConfigurationElementCollection modification a été modifiée depuis son dernier enregistrement ou son chargement en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
IsReadOnly()	Indique si l’objet ConfigurationElementCollection est en lecture seule. (Hérité de ConfigurationElementCollection)
ListErrors(IList)	Ajoute les erreurs de propriété non valides dans cet ConfigurationElement objet et, dans tous les sous-éléments, à la liste passée. (Hérité de ConfigurationElement)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnDeserializeUnrecognizedAttribute(String, String)	Obtient une valeur indiquant si un attribut inconnu est rencontré lors de la désérialisation. (Hérité de ConfigurationElement)
OnDeserializeUnrecognizedElement(String, XmlReader)	Gère la lecture des éléments de configuration non reconnus à partir d’un fichier de configuration et provoque la levée d’une exception par le système de configuration si l’élément ne peut pas être géré. (Hérité de ProfilePropertySettingsCollection)
OnRequiredPropertyNotFound(String)	Lève une exception lorsqu’une propriété requise est introuvable. (Hérité de ConfigurationElement)
PostDeserialize()	Appelé après la désérialisation. (Hérité de ConfigurationElement)
PreSerialize(XmlWriter)	Appelé avant la sérialisation. (Hérité de ConfigurationElement)
Remove(String)	Supprime un ProfilePropertySettings objet de la collection. (Hérité de ProfilePropertySettingsCollection)
RemoveAt(Int32)	Supprime un ProfilePropertySettings objet à l’emplacement d’index spécifié de la collection. (Hérité de ProfilePropertySettingsCollection)
Reset(ConfigurationElement)	Réinitialise l’état ConfigurationElementCollection non modifié en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
ResetModified()	Réinitialise la valeur de la IsModified() propriété false en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
SerializeElement(XmlWriter, Boolean)	Écrit les données de configuration dans un élément XML dans le fichier de configuration en cas de substitution dans une classe dérivée. (Hérité de ConfigurationElementCollection)
SerializeToXmlElement(XmlWriter, String)	Écrit les balises externes de cet élément de configuration dans le fichier de configuration en cas d’implémentation dans une classe dérivée. (Hérité de ConfigurationElement)
Set(ProfilePropertySettings)	Ajoute l’objet spécifié ProfilePropertySettings à la collection. (Hérité de ProfilePropertySettingsCollection)
SetPropertyValue(ConfigurationProperty, Object, Boolean)	Définit une propriété sur la valeur spécifiée. (Hérité de ConfigurationElement)
SetReadOnly()	Définit la IsReadOnly() propriété de l’objet ConfigurationElementCollection et de tous les sous-éléments. (Hérité de ConfigurationElementCollection)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
Unmerge(ConfigurationElement, ConfigurationElement, ConfigurationSaveMode)	Inverse l’effet de la fusion des informations de configuration à partir de différents niveaux de la hiérarchie de configuration. (Hérité de ConfigurationElementCollection)

Implémentations d’interfaces explicites

Nom	Description
ICollection.CopyTo(Array, Int32)	Copie le ConfigurationElementCollection tableau. (Hérité de ConfigurationElementCollection)

Méthodes d’extension

Nom	Description
AsParallel(IEnumerable)	Active la parallélisation d’une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.
Cast<TResult>(IEnumerable)	Convertit les éléments d’un IEnumerable en type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d’une IEnumerable en fonction d’un type spécifié.

Voir aussi

• ProfileSection
• PropertySettings
• ProfileGroupSettingsCollection