CancelEventArgs 類別

參考

定義

命名空間:: System.ComponentModel

組件:: System.ComponentModel.dll

組件:: System.dll

組件:: netstandard.dll

來源:: CancelEventArgs.cs

來源:: CancelEventArgs.cs

來源:: CancelEventArgs.cs

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供可取消事件的資料。

public ref class CancelEventArgs : EventArgs

public class CancelEventArgs : EventArgs

type CancelEventArgs = class
    inherit EventArgs

Public Class CancelEventArgs
Inherits EventArgs

繼承: Object

EventArgs
CancelEventArgs

衍生: Microsoft.VisualBasic.ApplicationServices.StartupEventArgs

System.ComponentModel.DoWorkEventArgs

System.Configuration.SettingChangingEventArgs

System.Drawing.Printing.PrintEventArgs

System.IdentityModel.Services.ErrorEventArgs

更多…

範例

下列範例會使用 CancelEventArgs 和 CancelEventHandler 來處理 Closing 的 Form事件。此程式代碼假設您已使用名為 isDataSaved的類別層級Boolean變數建立 Form 。它也假設您已新增語句，以 OtherInitialize 在呼叫) 之後，從表單的 Load 方法或建構函式 (叫 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

備註

當元件即將執行可取消的動作時，元件就會引發可取消的事件，例如 Closing 的事件 Form。

備註

事件 Closing 已被取代，且已由 FormClosing取代。此處僅提供作為範例，以說明的使用方式 CancelEventArgs。

CancelEventArgs Cancel提供屬性，指出是否應該取消事件。

建構函式

CancelEventArgs()	將 CancelEventArgs 屬性設定成 `false` 來初始化 Cancel 類別的新執行個體。
CancelEventArgs(Boolean)	將 CancelEventArgs 屬性設定成指定值來初始化 Cancel 類別的新執行個體。

屬性

Cancel

取得或設定值，這個值表示是否應該取消事件。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

適用於

產品	版本
.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

另請參閱

CancelEventHandler

分享方式：

CancelEventArgs 類別

定義

範例

備註

建構函式

屬性

方法

適用於

另請參閱

更多資源