ConvertEventArgs.Value Egenskap

Definition

Hämtar eller anger värdet för ConvertEventArgs.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };
public object Value { get; set; }
public object? Value { get; set; }
member this.Value : obj with get, set
Public Property Value As Object

Egenskapsvärde

Värdet för ConvertEventArgs.

Exempel

I följande kodexempel skapas ett Binding, lägger till ett ConvertEventHandler ombud för både Parse händelserna och Format och använder DataBindings egenskapen för att lägga Binding till i BindingsCollection en TextBox kontroll. Händelsedelegaten DecimalToCurrencyString , som läggs till i Format händelsen, använder ToString metoden för att formatera det bundna värdet (en Decimal typ) som valuta. Händelsedelegaten CurrencyStringToDecimal , som läggs till i Parse händelsen, konverterar värdet som visas av kontrollen tillbaka till Decimal typen.

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

Kommentarer

Värdet som ingår i Value egenskapen beror på vilken händelse som ConvertEventArgs returneras. ConvertEventArgs Kan returneras i antingen Format händelsen eller Parse händelsen.

ConvertEventArgs När returneras i Format händelsen Value innehåller egenskapen datakällans oformaterade egenskapsvärde. Format I händelsen kan du läsa egenskapsvärdet, formatera värdet och återställa Value egenskapen till det nya (formaterade) värdet och därmed ange värdet som visas i den databundna kontrollen.

ConvertEventArgs När returneras i Parse händelsen innehåller egenskapen det anpassade formaterade värdet för den databundna kontrollen. Parse I händelsen måste du läsa det formaterade värdet, parsa det och konvertera tillbaka det till samma datatyp som datakällan. Du kan sedan återställa Value egenskapen till det oformaterade värdet och därmed ange värdet för datakällan. Om du vill fastställa datakällans typ undersöker du egenskapsvärdet DesiredType .

Gäller för

Se även