ConvertEventArgs.Value Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la valeur du ConvertEventArgs.

public:
 property System::Object ^ Value { System::Object ^ get(); void set(System::Object ^ value); };

public object? Value { get; set; }

member this.Value : obj with get, set

Public Property Value As Object

Valeur de propriété

Object

Valeur de ConvertEventArgs.

Exemples

L’exemple de code suivant crée un Binding, ajoute un ConvertEventHandler délégué aux Parse événements et Format et utilise la DataBindings propriété pour ajouter au BindingBindingsCollection d’un TextBox contrôle. Le DecimalToCurrencyString délégué d’événement, qui est ajouté à l’événement Format , utilise la ToString méthode pour mettre en forme la valeur liée (un Decimal type) en tant que devise. Le CurrencyStringToDecimal délégué d’événement, qui est ajouté à l’événement Parse , convertit la valeur affichée par le contrôle en Decimal type.

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

Remarques

La valeur contenue par la Value propriété dépend de l’événement dans lequel le ConvertEventArgs est retourné. Le ConvertEventArgs peut être retourné dans l’événement Format ou dans l’événement Parse .

Lorsque le ConvertEventArgs est retourné dans l’événement Format , la Value propriété contient la valeur de propriété non mise en forme de la source de données. Dans l’événement Format , vous pouvez lire la valeur de la propriété, mettre en forme la valeur et réinitialiser la Value propriété à la nouvelle valeur (mise en forme), définissant ainsi la valeur affichée dans le contrôle lié aux données.

Lorsque le ConvertEventArgs est retourné dans l’événement Parse , la propriété contient la valeur au format personnalisé du contrôle lié aux données. Dans l’événement Parse , vous devez lire la valeur mise en forme, l’analyser et la convertir au même type de données que la source de données. Vous pouvez ensuite réinitialiser la Value propriété à la valeur non mise en forme et ainsi définir la valeur de la source de données. Pour déterminer le type de la source de données, examinez la valeur de la DesiredType propriété.

Voir aussi

• Binding