ConvertEventArgs Classe

Definição

public ref class ConvertEventArgs : EventArgs

public class ConvertEventArgs : EventArgs

type ConvertEventArgs = class
    inherit EventArgs

Public Class ConvertEventArgs
Inherits EventArgs

Herança

Object

EventArgs

ConvertEventArgs

Derivado

System.Windows.Forms.DataGridViewCellFormattingEventArgs

System.Windows.Forms.DataGridViewCellParsingEventArgs

System.Windows.Forms.ListControlConvertEventArgs

Exemplos

O exemplo de código seguinte cria um Binding, adiciona um ConvertEventHandler delegado tanto aos Parse eventos e Format e usa a DataBindings propriedade para adicionar o Binding ao BindingsCollection de um TextBox controlo. O DecimalToCurrencyString delegado do evento, que é adicionado ao Format evento, usa o ToString método para formatar o valor vinculado (um Decimal tipo) como moeda. O CurrencyStringToDecimal delegado do evento, que é adicionado ao Parse evento, converte o valor apresentado pelo controlo de volta para o Decimal tipo.

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" );
      
      // Adds the delegates to the events.
      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");
   // Adds the delegates to the events.
   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 Not cevent.DesiredType Is GetType(String) Then
      Return
   End If 
   ' Use the ToString method to format the value as currency ("c").
   cevent.Value = CDec(cevent.Value).ToString("c")
End Sub
 
 
Private Sub CurrencyStringToDecimal(sender As Object, cevent As ConvertEventArgs)
   ' The method converts back to decimal type only. 
   If Not cevent.DesiredType Is GetType(Decimal) Then
      Return
   End If 
   ' Converts 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()
   ' Creates the binding first. The OrderAmount is typed as Decimal.
   Dim b As New Binding("Text", ds, "customers.custToOrders.OrderAmount")
   ' Adds the delegates to the events.
   AddHandler b.Format, AddressOf DecimalToCurrencyString
   AddHandler b.Parse, AddressOf CurrencyStringToDecimal
   text1.DataBindings.Add(b)
End Sub

Observações

O ConvertEventArgs é usado para formatar e desformatar valores exibidos por um controlo Windows Forms que está ligado a dados através de um objeto Binding. O Format evento ocorre sempre que uma propriedade de controlo está vinculada a um valor e ocorre Parse sempre que o valor limitado muda.

Os Format eventos e Parse permitem criar formatos personalizados para mostrar dados. Por exemplo, se os dados numa tabela forem do tipo Decimal, pode especificar que os dados devem ser exibidos no formato da moeda local — definindo a Value propriedade de o ConvertEventArgs para o valor formatado no Format evento. Deve, consequentemente, desformatar o valor apresentado no Parse evento.

Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.

Ver também

• Binding
• BindingManagerBase
• BindingsCollection
• DataBindings