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

ProfileAutoSaveEventArgs, classe

Mise à jour : novembre 2007

Fournit les données destinées à l'événement ProfileAutoSaving de la classe ProfileModule.

Espace de noms :  System.Web.Profile
Assembly :  System.Web (dans System.Web.dll)

[AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal)]
public sealed class ProfileAutoSaveEventArgs : EventArgs
/** @attribute AspNetHostingPermissionAttribute(SecurityAction.LinkDemand, Level = AspNetHostingPermissionLevel.Minimal) */
public final class ProfileAutoSaveEventArgs extends EventArgs
public final class ProfileAutoSaveEventArgs extends EventArgs

Le délégué ProfileAutoSaveEventHandler est défini pour l'événement ProfileAutoSaving de la classe ProfileModule. Vous pouvez accéder à l'événement ProfileAutoSaving de la classe ProfileModule dans le fichier Global.asax de votre application ASP.NET, comme indiqué dans l'exemple pour cette rubrique. L'événement ProfileAutoSaving est déclenché à la fin de l'exécution de la page si la propriété ProfileManager.AutomaticSaveEnabled a la valeur true.

La méthode Save détermine automatiquement si les propriétés composées de types primitifs, de chaînes ou d'objets DateTime ont été modifiées, en vérifiant la valeur de la propriété IsDirty pour chaque SettingsPropertyValue du profil utilisateur. La méthode Save ne peut pas déterminer explicitement si une classe personnalisée a été modifiée. Vous pouvez utiliser l'événement ProfileAutoSaving pour déterminer si un objet personnalisé a été modifié, puis poursuivre avec l'enregistrement automatique si l'objet a été modifié ou annuler l'enregistrement automatique s'il n'a pas été modifié.

Pour annuler l'opération de sauvegarde automatique du profil, affectez à la propriété ContinueWithProfileAutoSave la valeur false dans l'événement ProfileAutoSaving ; sinon, affectez à la propriété ContinueWithProfileAutoSave la valeur true.

Il peut y avoir plusieurs abonnés à l'événement ProfileAutoSaving. ProfileModule utilisera la dernière valeur avec laquelle la propriété ContinueWithProfileAutoSave a été définie. Par conséquent, nous vous recommandons de définir explicitement la propriété ContinueWithProfileAutoSave dans l'événement ProfileAutoSaving, que vous annuliez ou exécutiez la sauvegarde automatique, dans la mesure où vous devez peut-être remplacer la valeur définie par un précédent abonné.

L'exemple de code suivant montre l'événement ProfileAutoSaving inclus dans le fichier Global.asax d'une application ASP.NET.

public void Profile_ProfileAutoSaving(object sender, ProfileAutoSaveEventArgs args)
{
  if (Profile.Cart.HasChanged)
    args.ContinueWithProfileAutoSave = true;
  else
    args.ContinueWithProfileAutoSave = false;
}


  • SecurityPermission 

    pour fonctionner dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal.

System.Object
  System.EventArgs
    System.Web.Profile.ProfileAutoSaveEventArgs

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

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

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0, 2.0
Afficher: