Binding.Format 이벤트

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Source:

Binding.cs

컨트롤의 속성이 데이터 값에 바인딩된 경우에 발생합니다.

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 

이벤트 유형

ConvertEventHandler

예제

다음 코드 예제에서는 만들고Binding, 대리자를 ConvertEventHandler 이벤트와 Format 이벤트에 추가하고Parse, 속성을 통해 DataBindings 컨트롤에 TextBox 추가 BindingBindingsCollection 합니다. 이벤트에 추가된 Format 이벤트 대리자는 DecimalToCurrencyString 메서드를 사용하여 ToString 바인딩된 값(Decimal형식)의 형식을 통화로 지정합니다. CurrencyStringToDecimal 이벤트에 추가 Parse 된 이벤트 대리자는 컨트롤이 표시하는 값을 다시 형식으로 Decimal 변환합니다.

이 예제에서는 명명ds된 .DataSet

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

설명

데이터가 Format 데이터 원본에서 컨트롤로 푸시될 때 이벤트가 발생합니다. 이벤트를 처리 Format 하여 형식이 지정되지 않은 데이터를 데이터 원본에서 서식이 지정된 데이터로 변환하여 표시할 수 있습니다. 컨트롤에서 데이터 원본으로 데이터를 끌어오면 표시된 값의 Parse 서식을 해제하기 위해 이벤트가 발생합니다. 그러면 Format 표시할 데이터의 서식을 다시 지정하는 이벤트가 발생합니다. 이렇게 하면 사용자가 컨트롤에 서식이 지정된 데이터나 서식이 지정되지 않은 데이터를 입력하는지 여부에 관계없이 바인딩된 컨트롤에 올바른 형식의 데이터가 표시됩니다.

Format 및 Parse 이벤트를 사용하면 데이터를 표시하기 위한 사용자 지정 형식을 만들 수 있습니다. 예를 들어 테이블의 데이터가 형식Decimal인 경우 이벤트의 형식이 지정된 값 Format 으로 속성을 ConvertEventArgs 설정 Value 하여 로컬 통화 형식으로 데이터를 표시할 수 있습니다. 따라서 이벤트에 표시된 값 Parse 의 서식을 해제해야 합니다.

이 Format 이벤트는 다음을 Current 포함하는 변경 내용의 값이 BindingManagerBase 변경 될 때마다 발생합니다.

• 속성이 처음 바인딩된 시간입니다.

• 언제든지 변경합니다 Position .

• 데이터 바인딩된 목록이 정렬되거나 필터링될 때마다 목록을 제공할 때 DataView 수행됩니다.

이 Format 이벤트는 이벤트 후에도 발생합니다 Parse . 예를 들어 컨트롤이 포커스를 잃으면 해당 내용이 구문 분석됩니다. 그 직후 새 데이터가 컨트롤 Format 에 푸시되면 이벤트가 발생하여 새 콘텐츠의 형식을 지정할 수 있습니다.

이벤트 처리에 대한 자세한 내용은 이벤트 처리 및 발생시키기를 참조하십시오.

추가 정보

• Parse
• OnFormat(ConvertEventArgs)