ConvertEventArgs Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Предоставляет данные для событий Format и Parse .

public ref class ConvertEventArgs : EventArgs

public class ConvertEventArgs : EventArgs

type ConvertEventArgs = class
    inherit EventArgs

Public Class ConvertEventArgs
Inherits EventArgs

Наследование

Object

EventArgs

ConvertEventArgs

Производный

System.Windows.Forms.DataGridViewCellFormattingEventArgs

System.Windows.Forms.DataGridViewCellParsingEventArgs

System.Windows.Forms.ListControlConvertEventArgs

Примеры

В следующем примере кода создается Binding, добавляется ConvertEventHandler делегат к событиям Parse и Format и используется DataBindings свойство для добавления BindingBindingsCollectionTextBox в элемент управления . Делегат 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" );
      
      // 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

Комментарии

ConvertEventArgs используется для форматирования и отмены форматирования значений, отображаемых элементом управления Windows Forms, привязанным к данным через Binding объект . Событие Format возникает всякий раз, когда свойство элемента управления привязано к значению, и Parse событие возникает при каждом изменении привязанного значения.

События Format и Parse позволяют создавать настраиваемые форматы для отображения данных. Например, если данные в таблице имеют тип Decimal, можно указать, что данные должны отображаться в формате локальной валюты, присвоив Value свойству ConvertEventArgs объекта значение форматирования в событии Format . Следовательно, необходимо отменить формат отображаемого значения в событии Parse .

Дополнительные сведения об обработке событий см. в разделе Обработка и вызов событий.

Конструкторы

ConvertEventArgs(Object, Type)

Инициализирует новый экземпляр класса ConvertEventArgs.

Свойства

DesiredType	Возвращает тип данных требуемого значения.
Value	Возвращает или задает значение ConvertEventArgs.

Методы

Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)

См. также раздел

• Binding
• BindingManagerBase
• BindingsCollection
• DataBindings