Binding.Format Binding.Format Binding.Format Binding.Format Event

Definizione

Viene generato quando la proprietà di un controllo viene associata a un valore di dati.Occurs when the property of a control is bound to a data value.

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 

Esempi

Nell'esempio di codice seguente viene Bindingcreato un oggetto ConvertEventHandler , viene aggiunto un Parse delegato Format a entrambi gli eventi e Binding e viene aggiunto l' TextBox oggetto all'oggetto DataBindings BindingsCollection di un controllo tramite il comando Proprietà.The following code example creates a Binding, adds a ConvertEventHandler delegate to both the Parse and Format events, and adds the Binding to the BindingsCollection of a TextBox control through the DataBindings property. Il DecimalToCurrencyString delegato dell'evento, aggiunto Format all'evento, formatta il valore associato (un Decimal tipo) come valuta usando il ToString metodo.The DecimalToCurrencyString event delegate, added to the Format event, formats the bound value (a Decimal type) as currency using the ToString method. Il CurrencyStringToDecimal delegato dell'evento, aggiunto Parse all'evento, converte il valore visualizzato dal controllo di Decimal nuovo nel tipo.The CurrencyStringToDecimal event delegate, added to the Parse event, converts the value displayed by the control back to the Decimal type.

In questo esempio si presuppone la presenza DataSet di dsun oggetto denominato.This example assumes the presence of a DataSet named ds.

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

Commenti

L' Format evento viene generato quando viene eseguito il push dei dati dall'origine dati al controllo.The Format event is raised when data is pushed from the data source into the control. È possibile gestire l' Format evento per convertire i dati non formattati dall'origine dati in dati formattati per la visualizzazione.You can handle the Format event to convert unformatted data from the data source into formatted data for display. Quando i dati vengono estratti dal controllo nell'origine dati, viene generato Parse l'evento per deformattare il valore visualizzato, quindi si verifica Format l'evento per riformattare i dati per la visualizzazione.When data is pulled from the control into the data source, the Parse event is raised to unformat the displayed value, then the Format event occurs to reformat the data for display. In questo modo, il controllo associato Visualizza i dati formattati correttamente, indipendentemente dal fatto che l'utente immetta dati formattati o non formattati nel controllo.This ensures that the bound control displays correctly formatted data regardless of whether the user enters formatted or unformatted data in the control.

Gli Format eventi Parse e consentono di creare formati personalizzati per la visualizzazione dei dati.The Format and Parse events allow you to create custom formats for displaying data. Se, ad esempio, i dati di una tabella sono di Decimaltipo, è possibile visualizzare i dati nel formato di valuta locale impostando Value la proprietà dell' ConvertEventArgs oggetto sul valore formattato nell' Format evento.For example, if the data in a table is of type Decimal, you can display the data in the local currency format by setting the Value property of the ConvertEventArgs to the formatted value in the Format event. È necessario quindi deformattare il valore visualizzato nell' Parse evento.You must consequently unformat the displayed value in the Parse event.

L' Format evento si verifica ogni Current volta che BindingManagerBase viene modificato il valore di, che include:The Format event occurs whenever the Current value of the BindingManagerBase changes, which includes:

  • La prima volta che la proprietà è associata.The first time the property is bound.

  • Ogni volta Position che viene modificato.Any time the Position changes.

  • Ogni volta che l'elenco associato a dati viene ordinato o filtrato, che viene DataView ottenuto quando un oggetto fornisce l'elenco.Whenever the data-bound list is sorted or filtered, which is accomplished when a DataView supplies the list.

L' Format evento si verifica anche dopo Parse l'evento.The Format event also occurs after the Parse event. Ad esempio, quando un controllo perde lo stato attivo, viene analizzato il relativo contenuto.For example, when a control loses focus, its contents are parsed. Immediatamente dopo, quando si effettua il push di nuovi dati nel controllo Format , l'evento si verifica consentendo la formattazione del nuovo contenuto.Immediately afterward, as new data is pushed into the control, the Format event occurs allowing the new contents to be formatted.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.For more information about handling events, see Handling and Raising Events.

Si applica a

Vedi anche