CancelEventArgs Classe

Référence

Définition

Espace de noms:: System.ComponentModel

Assembly:: System.ComponentModel.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: CancelEventArgs.cs

Source:: CancelEventArgs.cs

Source:: CancelEventArgs.cs

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.

Fournit des données pour un événement annulable.

public ref class CancelEventArgs : EventArgs

public class CancelEventArgs : EventArgs

type CancelEventArgs = class
    inherit EventArgs

Public Class CancelEventArgs
Inherits EventArgs

Héritage: Object

EventArgs
CancelEventArgs

Dérivé: Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

System.ComponentModel.DoWorkEventArgs

System.Configuration.SettingChangingEventArgs

System.Drawing.Printing.PrintEventArgs

System.IdentityModel.Services.ErrorEventArgs

Plus…

Exemples

L’exemple suivant utilise CancelEventArgs et pour CancelEventHandler gérer l’événement Closing d’un Form. Ce code suppose que vous avez créé un Form avec une variable de niveau Boolean classe nommée isDataSaved. Elle suppose également que vous avez ajouté une instruction pour appeler la OtherInitialize méthode à partir de la méthode du Load formulaire ou du constructeur (après l’appel à InitializeComponent).

private:
   // Call this method from the InitializeComponent() method of your form
   void OtherInitialize()
   {
      this->Closing += gcnew CancelEventHandler( this, &Form1::Form1_Cancel );
      this->myDataIsSaved = true;
   }

   void Form1_Cancel( Object^ /*sender*/, CancelEventArgs^ e )
   {
      if ( !myDataIsSaved )
      {
         e->Cancel = true;
         MessageBox::Show( "You must save first." );
      }
      else
      {
         e->Cancel = false;
         MessageBox::Show( "Goodbye." );
      }
   }

// Call this method from the constructor of your form
    private void OtherInitialize() {
       this.Closing += new CancelEventHandler(this.Form1_Closing);
       // Exchange commented line and note the difference.
       this.isDataSaved = true;
       //this.isDataSaved = false;
    }

    private void Form1_Closing(Object sender, CancelEventArgs e) {
       if (!isDataSaved) {
          e.Cancel = true;
          MessageBox.Show("You must save first.");
       }
       else {
          e.Cancel = false;
          MessageBox.Show("Goodbye.");
       }
    }

' Call this method from the Load method of your form.
Private Sub OtherInitialize()
    ' Exchange commented line and note the difference.
    Me.isDataSaved = True
    'Me.isDataSaved = False
End Sub

Private Sub Form1_Closing(sender As Object, e As _
   System.ComponentModel.CancelEventArgs) Handles MyBase.Closing
    If Not isDataSaved Then
        e.Cancel = True
        MessageBox.Show("You must save first.")
    Else
        e.Cancel = False
        MessageBox.Show("Goodbye.")
    End If
End Sub

Remarques

Un événement annulable est déclenché par un composant lorsqu’il est sur le point d’effectuer une action qui peut être annulée, telle que l’événement Closing d’un Form.

Note

L’événement Closing est déconseillé et a été remplacé par FormClosing. Il est proposé à titre d’exemple ici uniquement pour illustrer l’utilisation de CancelEventArgs.

CancelEventArgs fournit la Cancel propriété pour indiquer si l’événement doit être annulé.

Constructeurs

CancelEventArgs()	Initialise une nouvelle instance de la classe CancelEventArgs avec la propriété Cancel définie avec la valeur `false`.
CancelEventArgs(Boolean)	Initialise une nouvelle instance de la classe CancelEventArgs avec la propriété Cancel définie avec la valeur indiquée.

Propriétés

Cancel

Obtient ou définit une valeur indiquant si l'événement doit être annulé.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
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)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Produit	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	2.0, 2.1
UWP	10.0

Voir aussi

CancelEventHandler

Partager via