Binding.Parse 事件

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

Binding.cs

當資料綁定控制項的值改變時，會發生這種情況。

public:
 event System::Windows::Forms::ConvertEventHandler ^ Parse;

public event System.Windows.Forms.ConvertEventHandler? Parse;

member this.Parse : System.Windows.Forms.ConvertEventHandler 

Public Custom Event Parse As ConvertEventHandler 

事件類型

ConvertEventHandler

範例

以下程式碼範例建立 Binding，為 ConvertEventHandler 和 事件加入代理ParseFormat，並透過屬性DataBindings將 Binding 加入控制項TextBox的 。BindingsCollection DecimalToCurrencyString事件Format代理加入事件後，會利用該ToString方法將綁定值（型Decimal態）格式化為貨幣。 CurrencyStringToDecimal事件Parse代理加入事件後，會將控制項顯示的值轉換回該Decimal型別。

private:
   void DecimalToCurrencyString( Object^ /*sender*/, ConvertEventArgs^ cevent )
   {
      // The method converts only to string type. Test this using the DesiredType.
      if ( cevent->DesiredType != String::typeid )
      {
         return;
      }
      
      // Use the ToString method to format the value as currency ("c").
      cevent->Value = ( (Decimal)(cevent->Value) ).ToString( "c" );
   }

   void CurrencyStringToDecimal( Object^ /*sender*/, ConvertEventArgs^ cevent )
   {
      // The method converts back to decimal type only.
      if ( cevent->DesiredType != Decimal::typeid )
      {
         return;
      }
      
      // Converts the string back to decimal using the static Parse method.
      cevent->Value = Decimal::Parse( cevent->Value->ToString(),
         NumberStyles::Currency, nullptr );
   }

   void BindControl()
   {
      // Creates the binding first. The OrderAmount is typed as Decimal.
      Binding^ b = gcnew Binding(
         "Text", ds, "customers.custToOrders.OrderAmount" );
      // Add the delegates to the event.
      b->Format += gcnew ConvertEventHandler( this, &Form1::DecimalToCurrencyString );
      b->Parse += gcnew ConvertEventHandler( this, &Form1::CurrencyStringToDecimal );
      text1->DataBindings->Add( b );
   }

private void DecimalToCurrencyString(object sender, ConvertEventArgs cevent)
{
   // The method converts only to string type. Test this using the DesiredType.
   if(cevent.DesiredType != typeof(string)) return;

   // Use the ToString method to format the value as currency ("c").
   cevent.Value = ((decimal) cevent.Value).ToString("c");
}

private void CurrencyStringToDecimal(object sender, ConvertEventArgs cevent)
{
   // The method converts back to decimal type only.
   if(cevent.DesiredType != typeof(decimal)) return;

   // Converts the string back to decimal using the static Parse method.
   cevent.Value = Decimal.Parse(cevent.Value.ToString(),
   NumberStyles.Currency, null);
}

private void BindControl()
{
   // Creates the binding first. The OrderAmount is typed as Decimal.
   Binding b = new Binding
      ("Text", ds, "customers.custToOrders.OrderAmount");
   // Add the delegates to the event.
   b.Format += new ConvertEventHandler(DecimalToCurrencyString);
   b.Parse += new ConvertEventHandler(CurrencyStringToDecimal);
   text1.DataBindings.Add(b);
}

Private Sub DecimalToCurrencyString(sender As Object, cevent As ConvertEventArgs)
    ' The method converts only to string type. Test this using the DesiredType.
    If cevent.DesiredType IsNot GetType(String) Then
        Exit Sub
    End If
    
    ' Use the ToString method to format the value as currency ("c").
    cevent.Value = CType(cevent.Value, decimal).ToString("c")
End Sub

Private Sub CurrencyStringToDecimal(sender As Object, cevent As ConvertEventArgs)
    ' The method converts back to decimal type only.
    If cevent.DesiredType IsNot GetType(Decimal) Then
        Exit Sub
    End If

    ' Convert the string back to decimal using the shared Parse method.
   cevent.Value = Decimal.Parse(cevent.Value.ToString, _
  NumberStyles.Currency, nothing)

End Sub

Private Sub BindControl
    ' Create the binding first. The OrderAmount is typed as Decimal.
    Dim b As Binding = New Binding _
        ("Text", ds, "Customers.custToOrders.OrderAmount")
    ' Add the delegates to the event.
    AddHandler b.Format, AddressOf DecimalToCurrencyString
    AddHandler b.Parse, AddressOf CurrencyStringToDecimal
    text1.DataBindings.Add(b)
End Sub

備註

Format和Parse事件允許你建立自訂的顯示格式。 例如，如果資料表中的資料型別為 Decimal，你可以透過將 的ConvertEventArgs屬性設定Value為事件中的Format格式值來顯示當地貨幣格式。 因此，你必須取消事件中顯示的數值 Parse 格式化。

該 Parse 事件發生於以下條件：

• 事件發生後ValidatedControl。

• 當 EndCurrentEditBindingManagerBase 的方法被呼叫時。

• 當 的CurrentBindingManagerBase變化（換句話說，就是變化的時候Position）。

如需處理事件的詳細資訊，請參閱 處理和引發事件。

另請參閱

• Format
• OnParse(ConvertEventArgs)
• PositionChanged
• CurrentChanged