CurrencyManager.SuspendBinding 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

CurrencyManager.cs

暫止資料繫結以防止變更更新繫結的資料來源。

public:
 override void SuspendBinding();

public override void SuspendBinding ();

override this.SuspendBinding : unit -> unit

Public Overrides Sub SuspendBinding ()

範例

下列程式碼範例會示範如何使用 SuspendBinding 方法。

void button3_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
   try
   {
      BindingManagerBase^ myBindingManager1 = BindingContext[ myDataSet, "Customers" ];
      myBindingManager1->SuspendBinding();
   }
   catch ( Exception^ ex ) 
   {
      MessageBox::Show( ex->Source );
      MessageBox::Show( ex->Message );
   }
}

private void button3_Click(object sender, EventArgs e)
{
   try
   {
      BindingManagerBase myBindingManager1=BindingContext [myDataSet, "Customers"];
      myBindingManager1.SuspendBinding();
   }
   catch(Exception ex)
   {
      MessageBox.Show(ex.Source);
      MessageBox.Show(ex.Message);
   }
}

Private Sub button3_Click(sender As Object, e As EventArgs)
   Try
      Dim myBindingManager1 As BindingManagerBase = BindingContext(myDataSet, "Customers")
      myBindingManager1.SuspendBinding()
   Catch ex As Exception
      MessageBox.Show(ex.Source.ToString())
      MessageBox.Show(ex.Message.ToString())
   End Try
End Sub

備註

SuspendBinding和 ResumeBinding 方法允許在簡單系結案例中暫止和繼續資料系結。 如果使用者必須在驗證發生之前對資料欄位進行數個編輯，您通常會暫停資料系結。 例如，如果一個欄位必須根據第二個欄位進行變更，但驗證第一個欄位會導致第二個欄位發生錯誤。

注意

SuspendBinding 會防止變更套用至資料來源，直到呼叫 為止 ResumeBinding ，但實際上不會防止發生任何事件。 使用複雜資料系結的控制項，例如 DataGridView 控制項，會根據變更事件來更新其值，例如 ListChanged 事件。 因此，呼叫 SuspendBinding 不會防止複雜的繫結控制項接收事件來更新資料來源。 因此， SuspendBinding 和 ResumeBinding 是設計來搭配簡單繫結控制項使用，例如 TextBox 控制項。 或者，如果您藉由將 屬性設定 RaiseListChangedEvents 為 false 來隱藏 ListChanged 事件，則可以在複雜的系結案例中使用這些方法。

另請參閱

• RaiseListChangedEvents
• BindingComplete
• ResumeBinding()
• UpdateIsBinding()
• Bindings