CurrencyManager.CancelCurrentEdit メソッド

.NET Framework クラス ライブラリ リファレンス

CurrencyManager.CancelCurrentEdit メソッド

現在の編集操作をキャンセルします。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Overrides Sub CancelCurrentEdit

Visual Basic (使用法)

Dim instance As CurrencyManager

instance.CancelCurrentEdit

C#

public override void CancelCurrentEdit ()

C++

public:
virtual void CancelCurrentEdit () override

J#

public void CancelCurrentEdit ()

JScript

public override function CancelCurrentEdit
 ()

解説

このメソッドは、データ ソースによって格納されたオブジェクトが IEditableObject インターフェイスを実装している場合にだけサポートされます。データ ソース内に格納されたオブジェクトが IEditableObject インターフェイスを実装していない場合は、データへの変更は破棄されません。

メモ
このプロパティは、DataGrid コントロールなどの複合データ バインド コントロールで、編集をキャンセルする目的で使用するように設計されました。たとえば、Esc キーを押すと、CancelCurrentEdit メソッドが DataGrid の CurrencyManager に呼び出されます。作成するコントロールにこれと同じ機能を必要としないのならば、このメソッドの使用はお勧めしません。代わりに、DataRowView クラスの CancelEdit メソッドを使用します。

使用例

ユーザーが Esc キーを押したときに、CancelCurrentEdit を使用するコード例を次に示します。

Visual Basic

Private Sub dataGrid1_KeyUp(ByVal
 sender As Object, _
ByVal e As System.Windows.Forms.KeyEventArgs)

    If e.KeyCode = System.Windows.Forms.Keys.Escape Then
        ' Escape key pressed.
        Dim gridCurrencyManager As CurrencyManager
 = _
            CType(Me.BindingContext(dataGrid1.DataSource, _
            dataGrid1.DataMember), CurrencyManager)

        gridCurrencyManager.CancelCurrentEdit()
        MessageBox.Show("Escape!")
    End If
End Sub 'dataGrid1_KeyUp

C#

private void dataGrid1_KeyUp
(object sender, System.Windows.Forms.KeyEventArgs e)
{
   if(e.KeyCode == System.Windows.Forms.Keys.Escape){
      // Escape key pressed.
      CurrencyManager gridCurrencyManager = 
      (CurrencyManager)this.BindingContext[dataGrid1.DataSource,
 dataGrid1.DataMember];
      gridCurrencyManager.CancelCurrentEdit();
      MessageBox.Show("Escape!");
   }
}

C++

private:
   void dataGrid1_KeyUp( Object^ /*sender*/, System::Windows::Forms::KeyEventArgs^
 e )
   {
      if ( e->KeyCode == System::Windows::Forms::Keys::Escape
 )
      {
         
         // Escape key pressed.
         CurrencyManager^ gridCurrencyManager = dynamic_cast<CurrencyManager^>(this->BindingContext[dataGrid1->DataSource,
 dataGrid1->DataMember]);
         gridCurrencyManager->CancelCurrentEdit();
         MessageBox::Show( "Escape!" );
      }
   }

J#

protected void dataGrid1_KeyUp( Object sender,
 
    System.Windows.Forms.KeyEventArgs e)
{
    if (e.get_KeyCode().Equals(System.Windows.Forms.Keys.Escape))
 {
        // Escape key pressed.
        CurrencyManager gridCurrencyManager = 
            (CurrencyManager)(this.get_BindingContext().
            get_Item(dataGrid1.get_DataSource(),
            dataGrid1.get_DataMember()));
        gridCurrencyManager.CancelCurrentEdit();
        MessageBox.Show("Escape!");
    }
} //dataGrid1_KeyUp

JScript

protected function dataGrid1_KeyUp
(sender, e : System.Windows.Forms.KeyEventArgs)
{
   if(e.KeyCode == System.Windows.Forms.Keys.Escape){
      // Escape key pressed.
      var gridCurrencyManager : CurrencyManager  = 
      CurrencyManager(this.BindingContext[dataGrid1.DataSource,
 dataGrid1.DataMember]);
      gridCurrencyManager.CancelCurrentEdit();
      MessageBox.Show("Escape!");
   }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
CurrencyManager クラス
CurrencyManager メンバ
System.Windows.Forms 名前空間
EndCurrentEdit