Cette documentation est archivée et n’est pas conservée.

ProfileGroupSettings, classe

Remarque : cette classe est nouvelle dans le .NET Framework version 2.0.

Fournit l'accès par programme à la sous-section group de la section du fichier de configuration profiles.

Espace de noms : System.Web.Configuration
Assembly : System.Web (dans system.web.dll)

public sealed class ProfileGroupSettings : ConfigurationElement
public final class ProfileGroupSettings extends ConfigurationElement
public final class ProfileGroupSettings extends ConfigurationElement

La classe ProfileGroupSettings permet de créer, de consulter et de modifier par programme des groupes de propriétés ajoutés à la sous-section group de la section profile d'un fichier de configuration.

La section profile du fichier de configuration spécifie un schéma pour les profils utilisateur. Au moment de l'exécution, le système de compilation d'ASP.NET utilise les informations spécifiées dans la section profile pour générer une classe appelée ProfileCommon qui est dérivée de ProfileBase. La définition de la classe ProfileCommon est basée sur les propriétés définies dans la sous-section properties (section profile) du fichier de configuration. Une instance de cette classe est créée pour chaque profil utilisateur, et vous pouvez accéder aux valeurs de profil dans votre code grâce à la propriété HttpContext.Profile. Pour plus d'informations sur les nouvelles fonctionnalités de profil ajoutées à ASP.NET 2.0, consultez Propriétés de profils ASP.NET.

L'exemple de code suivant montre comment utiliser le type ProfileGroupSettings. Cet exemple de code fait partie d'un exemple plus développé fourni pour la classe ProfileSection.

// 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();

System.Object
   System.Configuration.ConfigurationElement
    System.Web.Configuration.ProfileGroupSettings

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: