Binding.Format Ereignis

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

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 

Ereignistyp

Beispiele

Im folgenden Codebeispiel wird ein BindingDelegat ConvertEventHandler sowohl zu den Parse Ereignissen FormatBinding als auch zum Hinzufügen des BindingsCollection Steuerelements TextBox über die DataBindings Eigenschaft erstellt. Der DecimalToCurrencyString Ereignisdelegat, der dem Format Ereignis hinzugefügt wird, formatiert den gebundenen Wert (einen Decimal Typ) mithilfe der ToString Methode als Währung. Der CurrencyStringToDecimal Ereignisdelegat, der dem Parse Ereignis hinzugefügt wird, konvertiert den vom Steuerelement angezeigten Wert wieder in den Decimal Typ.

In diesem Beispiel wird davon ausgegangen, dass ein benannter DataSet Name dsvorhanden ist.

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

Hinweise

Das Format Ereignis wird ausgelöst, wenn Daten aus der Datenquelle in das Steuerelement übertragen werden. Sie können das Format Ereignis behandeln, um unformatierte Daten aus der Datenquelle in formatierte Daten für die Anzeige zu konvertieren. Wenn Daten aus dem Steuerelement in die Datenquelle abgerufen werden, wird das Parse Ereignis ausgelöst, um den angezeigten Wert zu unformatieren, und das Format Ereignis tritt auf, um die Daten für die Anzeige neu zu formatieren. Dadurch wird sichergestellt, dass das gebundene Steuerelement korrekt formatierte Daten anzeigt, unabhängig davon, ob der Benutzer formatierte oder nicht formatierte Daten in das Steuerelement eingibt.

Mit den Format Ereignissen Parse können Sie benutzerdefinierte Formate zum Anzeigen von Daten erstellen. Wenn die Daten in einer Tabelle z. B. vom Typ Decimalsind, können Sie die Daten im lokalen Währungsformat anzeigen, indem Sie die Value Eigenschaft des ConvertEventArgs Werts auf den formatierten Wert im Format Ereignis festlegen. Daher müssen Sie den angezeigten Wert im Parse Ereignis nicht formatieren.

Das Format Ereignis tritt immer dann auf, wenn sich der Current Wert der BindingManagerBase Änderungen ändert, die Folgendes umfasst:

• Das erste Mal, wenn die Eigenschaft gebunden ist.

• Jedes Mal, wenn sich die Position Änderungen ändern.

• Immer, wenn die datengebundene Liste sortiert oder gefiltert wird, die erreicht wird, wenn eine DataView Liste liefert.

Das Format Ereignis tritt auch nach dem Parse Ereignis auf. Wenn beispielsweise ein Steuerelement den Fokus verliert, werden dessen Inhalte analysiert. Sobald neue Daten in das Steuerelement übertragen werden, tritt das Format Ereignis auf, sodass der neue Inhalt formatiert werden kann.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Weitere Informationen

• Parse
• OnFormat(ConvertEventArgs)