Freigeben über

CancelEventArgs Klasse

Definition

Namespace:
System.ComponentModel
Assemblys:
System.dll, System.ComponentModel.dll
Assemblys:
netstandard.dll, System.ComponentModel.dll
Assembly:
System.ComponentModel.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Quelle:
CancelEventArgs.cs
Quelle:
CancelEventArgs.cs
Quelle:
CancelEventArgs.cs
Quelle:
CancelEventArgs.cs
Quelle:
CancelEventArgs.cs

Stellt Daten für ein abbruchfähiges Ereignis bereit.

public ref class CancelEventArgs : EventArgs
public class CancelEventArgs : EventArgs
type CancelEventArgs = class
    inherit EventArgs
Public Class CancelEventArgs
Inherits EventArgs
Vererbung
Object
EventArgs
CancelEventArgs
Abgeleitet

Beispiele

Im folgenden Beispiel wird CancelEventArgsCancelEventHandler das Closing Ereignis eines .Form Dieser Code geht davon aus, dass Sie eine Form Variable auf Klassenebene Boolean mit dem Namen isDataSavederstellt haben. Außerdem wird davon ausgegangen, dass Sie eine Anweisung hinzugefügt haben, um die OtherInitialize Methode aus der Methode des Formulars Load oder dem Konstruktor (nach dem Aufruf von InitializeComponent) aufzurufen.

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
void OtherInitialize()
{
    Closing += Form1_Closing;
    // Exchange commented line and note the difference.
    isDataSaved = true;
    //this.isDataSaved = false;
}

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

Hinweise

Ein abbruchfähiges Ereignis wird von einer Komponente ausgelöst, wenn es darum geht, eine Aktion auszuführen, die abgebrochen werden kann, z. B. das Closing Ereignis eines Form.

Hinweis

Das Closing Ereignis ist veraltet und wurde durch FormClosingersetzt. Es wird hier als Beispiel nur zur Veranschaulichung der Verwendung angeboten CancelEventArgs.

CancelEventArgs stellt die Cancel Eigenschaft bereit, um anzugeben, ob das Ereignis abgebrochen werden soll.

Konstruktoren

Name Beschreibung
CancelEventArgs()

Initialisiert eine neue Instanz der CancelEventArgs Klasse, wobei die Cancel Eigenschaft auf .false
CancelEventArgs(Boolean)

Initialisiert eine neue Instanz der CancelEventArgs Klasse, wobei die Cancel Eigenschaft auf den angegebenen Wert festgelegt ist.

Eigenschaften

Name Beschreibung
Cancel

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Ereignis abgebrochen werden soll.

Methoden

Name Beschreibung
Equals(Object)

Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht.

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetType()

Ruft die Type der aktuellen Instanz ab.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Gilt für:

Weitere Informationen