ConvertEventArgs.Value Свойство

Определение

Возвращает или задает значение ConvertEventArgs.

public object Value { get; set; }
public object? Value { get; set; }

Значение свойства

Значение ConvertEventArgs.

Примеры

В следующем примере кода создается 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 != 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);
}

Комментарии

Значение, содержащееся в свойстве , Value зависит от события, в котором ConvertEventArgs возвращается . Объект ConvertEventArgs может быть возвращен как в событии, Format так и в событии Parse .

ConvertEventArgs Когда возвращается в событии Format , Value свойство содержит неформатированное значение свойства источника данных. В событии Format можно считать значение свойства, отформатировать значение и сбросить Value свойство до нового (форматированного) значения, тем самым задав значение, отображаемое в элементе управления с привязкой к данным.

ConvertEventArgs Когда возвращается в событии Parse , свойство содержит настраиваемое значение элемента управления с привязкой к данным. В событии Parse необходимо прочитать форматируемое значение, проанализировать его и преобразовать обратно в тот же тип данных, что и источник данных. Затем можно сбросить Value свойство до неформатированного значения и таким образом задать значение источника данных. Чтобы определить тип источника данных, изучите DesiredType значение свойства .

Применяется к

Өнім Нұсқалар
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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