Binding.Format Gebeurtenis

public:
 event System::Windows::Forms::ConvertEventHandler ^ Format;

public event System.Windows.Forms.ConvertEventHandler Format;

member this.Format : System.Windows.Forms.ConvertEventHandler 

Public Custom Event Format As ConvertEventHandler 

Gebeurtenistype

Voorbeelden

In het volgende codevoorbeeld wordt een BindingConvertEventHandler gemachtigde aan zowel de als Format de Parse gebeurtenissen toegevoegd en wordt het Binding aan een BindingsCollectionTextBox besturingselement toegevoegd via de DataBindings eigenschap. De DecimalToCurrencyString gebeurtenisdelegatie, toegevoegd aan de Format gebeurtenis, maakt de afhankelijke waarde (een Decimal type) op als valuta met behulp van de ToString methode. De CurrencyStringToDecimal gedelegeerde van de gebeurtenis, toegevoegd aan de Parse gebeurtenis, converteert de waarde die door het besturingselement wordt weergegeven terug naar het Decimal type.

In dit voorbeeld wordt ervan uitgegaan dat een DataSet benoemde dsnaam aanwezig is.

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 a Decimal type.
      Binding^ b = gcnew Binding(
         "Text",ds,"customers.custToOrders.OrderAmount" );
      
      // Add the delegates to the event.
      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 a Decimal type.
   Binding b = new Binding
      ("Text", ds, "customers.custToOrders.OrderAmount");
   // Add the delegates to the event.
   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 cevent.DesiredType IsNot GetType(String) Then
      Exit Sub
   End If

   ' Use the ToString method to format the value as currency ("c").
   cevent.Value = CType(cevent.Value, Decimal).ToString("c")
End Sub

Private Sub CurrencyStringToDecimal(sender As Object, cevent As _
ConvertEventArgs)
   ' The method converts back to decimal type only.
   If cevent.DesiredType IsNot GetType(Decimal) Then
      Exit Sub
   End If

   ' Converts the string back to decimal using the static ToDecimal method.
   cevent.Value = Decimal.Parse(cevent.Value.ToString, _
   NumberStyles.Currency, nothing)
End Sub

Private Sub BindControl
   ' Creates the binding first. The OrderAmount is a Decimal type.
   Dim b As Binding = New Binding _
      ("Text", ds, "customers.custToOrders.OrderAmount")
   ' Add the delegates to the event
   AddHandler b.Format, AddressOf DecimalToCurrencyString
   AddHandler b.Parse, AddressOf CurrencyStringToDecimal
   text1.DataBindings.Add(b)
End Sub

Opmerkingen

De Format gebeurtenis wordt gegenereerd wanneer gegevens vanuit de gegevensbron naar het besturingselement worden gepusht. U kunt de Format gebeurtenis afhandelen om niet-opgemaakte gegevens uit de gegevensbron te converteren naar opgemaakte gegevens voor weergave. Wanneer gegevens worden opgehaald uit het besturingselement in de gegevensbron, wordt de Parse gebeurtenis gegenereerd om de weergegeven waarde op te maken en treedt de Format gebeurtenis op om de gegevens opnieuw op te maken voor weergave. Dit zorgt ervoor dat met het afhankelijke besturingselement correct opgemaakte gegevens worden weergegeven, ongeacht of de gebruiker opgemaakte of niet-opgemaakte gegevens invoert in het besturingselement.

Met de Format en Parse gebeurtenissen kunt u aangepaste indelingen maken voor het weergeven van gegevens. Als de gegevens in een tabel bijvoorbeeld van het type Decimalzijn, kunt u de gegevens weergeven in de lokale valuta-indeling door de eigenschap van de ValueConvertEventArgs waarde in te stellen op de opgemaakte waarde in de Format gebeurtenis. Daarom moet u de weergegeven waarde in de Parse gebeurtenis opheffen.

De Format gebeurtenis vindt plaats wanneer de Current waarde van de BindingManagerBase wijzigingen, waaronder:

• De eerste keer dat de eigenschap is gebonden.

• Telkens wanneer de Position wijzigingen zijn doorgevoerd.

• Wanneer de gegevensgebonden lijst wordt gesorteerd of gefilterd, wat wordt bereikt wanneer een DataView lijst wordt geleverd.

De Format gebeurtenis vindt ook plaats na de Parse gebeurtenis. Wanneer een besturingselement bijvoorbeeld de focus verliest, wordt de inhoud geparseerd. Direct daarna, wanneer nieuwe gegevens naar het besturingselement worden gepusht, treedt de Format gebeurtenis op zodat de nieuwe inhoud kan worden opgemaakt.

Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.

Zie ook

• Parse
• OnFormat(ConvertEventArgs)