Binding Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Représente la liaison simple entre la valeur de propriété d’un objet et la valeur de propriété d’un contrôle.

public ref class Binding

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListBindingConverter))]
public class Binding

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListBindingConverter))>]
type Binding = class

Public Class Binding

Héritage

Object

Binding

Attributs

TypeConverterAttribute

Exemples

L’exemple de code suivant crée un Windows Form avec plusieurs contrôles qui illustrent une liaison de données simple. L’exemple crée une DataSet avec deux tables nommées Customers et Orders, et un DataRelation nommé custToOrders. Quatre contrôles (un DateTimePicker et trois contrôles TextBox) sont des données liées aux colonnes des tables. Pour chaque contrôle, l’exemple crée et ajoute une Binding au contrôle via la propriété DataBindings. L’exemple retourne un BindingManagerBase pour chaque table par le biais de la BindingContextdu formulaire. Quatre contrôles Button incrémentent ou décrémentent la propriété Position sur les objets BindingManagerBase.

#using <system.dll>
#using <system.data.dll>
#using <system.drawing.dll>
#using <system.windows.forms.dll>
#using <system.xml.dll>

using namespace System;
using namespace System::Data;
using namespace System::Drawing;
using namespace System::Globalization;
using namespace System::Windows::Forms;

#define null 0L
public ref class Form1: public Form
{
private:
   System::ComponentModel::Container^ components;
   Button^ button1;
   Button^ button2;
   Button^ button3;
   Button^ button4;
   TextBox^ text1;
   TextBox^ text2;
   TextBox^ text3;
   BindingManagerBase^ bmCustomers;
   BindingManagerBase^ bmOrders;
   DataSet^ ds;
   DateTimePicker^ DateTimePicker1;

public:
   Form1()
   {
      // Required for Windows Form Designer support.
      InitializeComponent();

      // Call SetUp to bind the controls.
      SetUp();
   }

private:
   void InitializeComponent()
   {
      // Create the form and its controls.
      this->components = gcnew System::ComponentModel::Container;
      this->button1 = gcnew Button;
      this->button2 = gcnew Button;
      this->button3 = gcnew Button;
      this->button4 = gcnew Button;
      this->text1 = gcnew TextBox;
      this->text2 = gcnew TextBox;
      this->text3 = gcnew TextBox;
      this->DateTimePicker1 = gcnew DateTimePicker;
      this->Text =  "Binding Sample";
      this->ClientSize = System::Drawing::Size( 450, 200 );
      button1->Location = System::Drawing::Point( 24, 16 );
      button1->Size = System::Drawing::Size( 64, 24 );
      button1->Text =  "<";
      button1->Click += gcnew System::EventHandler( this, &Form1::button1_Click );
      button2->Location = System::Drawing::Point( 90, 16 );
      button2->Size = System::Drawing::Size( 64, 24 );
      button2->Text =  ">";
      button2->Click += gcnew System::EventHandler( this, &Form1::button2_Click );
      button3->Location = System::Drawing::Point( 90, 100 );
      button3->Size = System::Drawing::Size( 64, 24 );
      button3->Text =  "<";
      button3->Click += gcnew System::EventHandler( this, &Form1::button3_Click );
      button4->Location = System::Drawing::Point( 150, 100 );
      button4->Size = System::Drawing::Size( 64, 24 );
      button4->Text =  ">";
      button4->Click += gcnew System::EventHandler( this, &Form1::button4_Click );
      text1->Location = System::Drawing::Point( 24, 50 );
      text1->Size = System::Drawing::Size( 150, 24 );
      text2->Location = System::Drawing::Point( 190, 50 );
      text2->Size = System::Drawing::Size( 150, 24 );
      text3->Location = System::Drawing::Point( 290, 150 );
      text3->Size = System::Drawing::Size( 150, 24 );
      DateTimePicker1->Location = System::Drawing::Point( 90, 150 );
      DateTimePicker1->Size = System::Drawing::Size( 200, 800 );
      this->Controls->Add( button1 );
      this->Controls->Add( button2 );
      this->Controls->Add( button3 );
      this->Controls->Add( button4 );
      this->Controls->Add( text1 );
      this->Controls->Add( text2 );
      this->Controls->Add( text3 );
      this->Controls->Add( DateTimePicker1 );
   }

public:
   ~Form1()
   {
      if ( components != nullptr )
      {
         delete components;
      }
   }

private:
   void SetUp()
   {
      // Create a DataSet with two tables and one relation.
      MakeDataSet();
      BindControls();
   }

protected:
   void BindControls()
   {
      /* Create two Binding objects for the first two TextBox 
              controls. The data-bound property for both controls 
              is the Text property. The data source is a DataSet 
              (ds). The data member is the 
              "TableName.ColumnName" string. */
      text1->DataBindings->Add( gcnew Binding( "Text",ds,"customers.custName" ) );
      text2->DataBindings->Add( gcnew Binding( "Text",ds,"customers.custID" ) );

      /* Bind the DateTimePicker control by adding a new Binding. 
              The data member of the DateTimePicker is a 
              TableName.RelationName.ColumnName string. */
      DateTimePicker1->DataBindings->Add( gcnew Binding( "Value",ds,"customers.CustToOrders.OrderDate" ) );

      /* Add event delegates for the Parse and Format events to a 
              new Binding object, and add the object to the third 
              TextBox control's BindingsCollection. The delegates 
              must be added before adding the Binding to the 
              collection; otherwise, no formatting occurs until 
              the Current object of the BindingManagerBase for 
              the data source changes. */
      Binding^ b = gcnew Binding( "Text",ds,"customers.custToOrders.OrderAmount" );
      b->Parse += gcnew ConvertEventHandler( this, &Form1::CurrencyStringToDecimal );
      b->Format += gcnew ConvertEventHandler( this, &Form1::DecimalToCurrencyString );
      text3->DataBindings->Add( b );

      // Get the BindingManagerBase for the Customers table. 
      bmCustomers = this->BindingContext[ ds, "Customers" ];

      /* Get the BindingManagerBase for the Orders table using the 
              RelationName. */
      bmOrders = this->BindingContext[ ds, "customers.CustToOrders" ];
   }

private:
   void DecimalToCurrencyString( Object^ /*sender*/, ConvertEventArgs^ cevent )
   {
      /* This method is the Format event handler. Whenever the 
              control displays a new value, the value is converted from 
              its native Decimal type to a string. The ToString method 
              then formats the value as a Currency, by using the 
              formatting character "c". */
      // The application can only convert to string type. 
      if ( cevent->DesiredType != String::typeid )
            return;

      cevent->Value = (dynamic_cast<Decimal^>(cevent->Value))->ToString( "c" );
   }

   void CurrencyStringToDecimal( Object^ /*sender*/, ConvertEventArgs^ cevent )
   {
      /* This method is the Parse event handler. The Parse event 
              occurs whenever the displayed value changes. The static 
              ToDecimal method of the Convert class converts the 
              value back to its native Decimal type. */
      // Can only convert to Decimal type.
      if ( cevent->DesiredType != Decimal::typeid )
            return;

      cevent->Value = Decimal::Parse( cevent->Value->ToString(), NumberStyles::Currency, nullptr );
      
      /* To see that no precision is lost, print the unformatted 
              value. For example, changing a value to "10.0001" 
              causes the control to display "10.00", but the 
              unformatted value remains "10.0001". */
      Console::WriteLine( cevent->Value );
   }

private:
   void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Go to the previous item in the Customer list.
      bmCustomers->Position -= 1;
   }

   void button2_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      // Go to the next item in the Customer list.
      bmCustomers->Position += 1;
   }

   void button3_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Go to the previous item in the Orders list.
      bmOrders->Position = bmOrders->Position - 1;
   }

   void button4_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Go to the next item in the Orders list.
      bmOrders->Position = bmOrders->Position + 1;
   }

private:

   // Create a DataSet with two tables and populate it.
   void MakeDataSet()
   {
      // Create a DataSet.
      ds = gcnew DataSet( "myDataSet" );

      // Create two DataTables.
      DataTable^ tCust = gcnew DataTable( "Customers" );
      DataTable^ tOrders = gcnew DataTable( "Orders" );

      // Create two columns, and add them to the first table.
      DataColumn^ cCustID = gcnew DataColumn( "CustID",Int32::typeid );
      DataColumn^ cCustName = gcnew DataColumn( "CustName" );
      tCust->Columns->Add( cCustID );
      tCust->Columns->Add( cCustName );

      // Create three columns, and add them to the second table.
      DataColumn^ cID = gcnew DataColumn( "CustID",Int32::typeid );
      DataColumn^ cOrderDate = gcnew DataColumn( "orderDate",DateTime::typeid );
      DataColumn^ cOrderAmount = gcnew DataColumn( "OrderAmount",Decimal::typeid );
      tOrders->Columns->Add( cOrderAmount );
      tOrders->Columns->Add( cID );
      tOrders->Columns->Add( cOrderDate );

      // Add the tables to the DataSet.
      ds->Tables->Add( tCust );
      ds->Tables->Add( tOrders );

      // Create a DataRelation, and add it to the DataSet.
      DataRelation^ dr = gcnew DataRelation( "custToOrders",cCustID,cID );
      ds->Relations->Add( dr );
      
      /* Populate the tables. For each customer and order, 
              create two DataRow variables. */
      DataRow^ newRow1; // = new DataRow();

      DataRow^ newRow2; // = new DataRow();

      // Create three customers in the Customers Table.
      for ( int i = 1; i < 4; i++ )
      {
         newRow1 = tCust->NewRow();
         newRow1[ "custID" ] = i;
         
         // Add the row to the Customers table.
         tCust->Rows->Add( newRow1 );

      }
      tCust->Rows[ 0 ][ "custName" ] = "Alpha";
      tCust->Rows[ 1 ][ "custName" ] = "Beta";
      tCust->Rows[ 2 ][ "custName" ] = "Omega";
      
      // For each customer, create five rows in the Orders table.
      for ( int i = 1; i < 4; i++ )
      {
         for ( int j = 1; j < 6; j++ )
         {
            newRow2 = tOrders->NewRow();
            newRow2[ "CustID" ] = i;
            newRow2[ "orderDate" ] = System::DateTime( 2001, i, j * 2 );
            newRow2[ "OrderAmount" ] = i * 10 + j * .1;
            
            // Add the row to the Orders table.
            tOrders->Rows->Add( newRow2 );
         }
      }
   }
};

int main()
{
   Application::Run( gcnew Form1 );
}

using System;
using System.Data;
using System.Drawing;
using System.Globalization;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
   private System.ComponentModel.Container components;
   private Button button1;
   private Button button2;
   private Button button3;
   private Button button4;
   private TextBox text1;
   private TextBox text2;
   private TextBox text3;

   private BindingManagerBase bmCustomers;
   private BindingManagerBase bmOrders;
   private DataSet ds;
   private DateTimePicker DateTimePicker1;

   public Form1()
   {
      // Required for Windows Form Designer support.
      InitializeComponent();
      // Call SetUp to bind the controls.
      SetUp();
   }
 
   private void InitializeComponent()
   {
      // Create the form and its controls.
      this.components = new System.ComponentModel.Container();
      this.button1 = new System.Windows.Forms.Button();
      this.button2 = new System.Windows.Forms.Button();
      this.button3 = new System.Windows.Forms.Button();
      this.button4 = new System.Windows.Forms.Button();
      
      this.text1= new System.Windows.Forms.TextBox();
      this.text2= new System.Windows.Forms.TextBox();
      this.text3= new System.Windows.Forms.TextBox();
      
      this.DateTimePicker1 = new DateTimePicker();
      
      this.Text = "Binding Sample";
      this.ClientSize = new System.Drawing.Size(450, 200);
      
      button1.Location = new System.Drawing.Point(24, 16);
      button1.Size = new System.Drawing.Size(64, 24);
      button1.Text = "<";
      button1.Click+=new System.EventHandler(button1_Click);

      button2.Location = new System.Drawing.Point(90, 16);
      button2.Size = new System.Drawing.Size(64, 24);
      button2.Text = ">";
      button2.Click+=new System.EventHandler(button2_Click);

      button3.Location = new System.Drawing.Point(90, 100);
      button3.Size = new System.Drawing.Size(64, 24);
      button3.Text = "<";
      button3.Click+=new System.EventHandler(button3_Click);

      button4.Location = new System.Drawing.Point(150, 100);
      button4.Size = new System.Drawing.Size(64, 24);
      button4.Text = ">";
      button4.Click+=new System.EventHandler(button4_Click);

      text1.Location = new System.Drawing.Point(24, 50);
      text1.Size = new System.Drawing.Size(150, 24);

      text2.Location = new System.Drawing.Point(190, 50);
      text2.Size = new System.Drawing.Size(150, 24);

      text3.Location = new System.Drawing.Point(290, 150);
      text3.Size = new System.Drawing.Size(150, 24);
      
      DateTimePicker1.Location = new System.Drawing.Point(90, 150);
      DateTimePicker1.Size = new System.Drawing.Size(200, 800);
      
      this.Controls.Add(button1);
      this.Controls.Add(button2);
      this.Controls.Add(button3);
      this.Controls.Add(button4);
      this.Controls.Add(text1);
      this.Controls.Add(text2);
      this.Controls.Add(text3);
      this.Controls.Add(DateTimePicker1);
   }

   protected override void Dispose( bool disposing ){
      if( disposing ){
         if (components != null){
            components.Dispose();}
      }
      base.Dispose( disposing );
   }
   public static void Main()
   {
      Application.Run(new Form1());
   }
   
   private void SetUp()
   {
      // Create a DataSet with two tables and one relation.
      MakeDataSet();
      BindControls();
   }

   protected void BindControls()
   {
      /* Create two Binding objects for the first two TextBox 
         controls. The data-bound property for both controls 
         is the Text property. The data source is a DataSet 
         (ds). The data member is the  
         "TableName.ColumnName" string. */
      text1.DataBindings.Add(new Binding
      ("Text", ds, "customers.custName"));
      text2.DataBindings.Add(new Binding
      ("Text", ds, "customers.custID"));
      
      /* Bind the DateTimePicker control by adding a new Binding. 
         The data member of the DateTimePicker is a 
         TableName.RelationName.ColumnName string. */
      DateTimePicker1.DataBindings.Add(new 
      Binding("Value", ds, "customers.CustToOrders.OrderDate"));

      /* Add event delegates for the Parse and Format events to a 
         new Binding object, and add the object to the third 
         TextBox control's BindingsCollection. The delegates 
         must be added before adding the Binding to the 
         collection; otherwise, no formatting occurs until 
         the Current object of the BindingManagerBase for 
         the data source changes. */
      Binding b = new Binding
         ("Text", ds, "customers.custToOrders.OrderAmount");
      b.Parse+=new ConvertEventHandler(CurrencyStringToDecimal);
      b.Format+=new ConvertEventHandler(DecimalToCurrencyString);
      text3.DataBindings.Add(b);

      // Get the BindingManagerBase for the Customers table. 
      bmCustomers = this.BindingContext [ds, "Customers"];

      /* Get the BindingManagerBase for the Orders table using the 
         RelationName. */ 
      bmOrders = this.BindingContext[ds, "customers.CustToOrders"];
   }

   private void DecimalToCurrencyString(object sender, ConvertEventArgs cevent)
   {
      /* This method is the Format event handler. Whenever the 
         control displays a new value, the value is converted from 
         its native Decimal type to a string. The ToString method 
         then formats the value as a Currency, by using the 
         formatting character "c". */

      // The application can only convert to string type. 
      if(cevent.DesiredType != typeof(string)) return;

      cevent.Value = ((decimal) cevent.Value).ToString("c");
   }

   private void CurrencyStringToDecimal(object sender, ConvertEventArgs cevent)
   {   
      /* This method is the Parse event handler. The Parse event 
         occurs whenever the displayed value changes. The static 
         ToDecimal method of the Convert class converts the 
         value back to its native Decimal type. */

      // Can only convert to decimal type.
      if(cevent.DesiredType != typeof(decimal)) return;

      cevent.Value = Decimal.Parse(cevent.Value.ToString(),
        NumberStyles.Currency, null);

      /* To see that no precision is lost, print the unformatted 
         value. For example, changing a value to "10.0001" 
         causes the control to display "10.00", but the 
         unformatted value remains "10.0001". */
      Console.WriteLine(cevent.Value);
   }

   private void button1_Click(object sender, System.EventArgs e)
   {
      // Go to the previous item in the Customer list.
      bmCustomers.Position -= 1;
   }

   private void button2_Click(object sender, System.EventArgs e)
   {
      // Go to the next item in the Customer list.
      bmCustomers.Position += 1;
   }
    
   private void button3_Click(object sender, System.EventArgs e)
   {
      // Go to the previous item in the Orders list.
      bmOrders.Position-=1;
   }

   private void button4_Click(object sender, System.EventArgs e)
   {
      // Go to the next item in the Orders list.
      bmOrders.Position+=1;
   }

   // Create a DataSet with two tables and populate it.
   private void MakeDataSet()
   {
      // Create a DataSet.
      ds = new DataSet("myDataSet");
      
      // Create two DataTables.
      DataTable tCust = new DataTable("Customers");
      DataTable tOrders = new DataTable("Orders");

      // Create two columns, and add them to the first table.
      DataColumn cCustID = new DataColumn("CustID", typeof(int));
      DataColumn cCustName = new DataColumn("CustName");
      tCust.Columns.Add(cCustID);
      tCust.Columns.Add(cCustName);

      // Create three columns, and add them to the second table.
      DataColumn cID = 
         new DataColumn("CustID", typeof(int));
      DataColumn cOrderDate = 
         new DataColumn("orderDate",typeof(DateTime));
      DataColumn cOrderAmount = 
         new DataColumn("OrderAmount", typeof(decimal));
      tOrders.Columns.Add(cOrderAmount);
      tOrders.Columns.Add(cID);
      tOrders.Columns.Add(cOrderDate);

      // Add the tables to the DataSet.
      ds.Tables.Add(tCust);
      ds.Tables.Add(tOrders);

      // Create a DataRelation, and add it to the DataSet.
      DataRelation dr = new DataRelation
      ("custToOrders", cCustID , cID);
      ds.Relations.Add(dr);
   
      /* Populate the tables. For each customer and order, 
         create two DataRow variables. */
      DataRow newRow1;
      DataRow newRow2;

      // Create three customers in the Customers Table.
      for(int i = 1; i < 4; i++)
      {
         newRow1 = tCust.NewRow();
         newRow1["custID"] = i;
         // Add the row to the Customers table.
         tCust.Rows.Add(newRow1);
      }
      // Give each customer a distinct name.
      tCust.Rows[0]["custName"] = "Alpha";
      tCust.Rows[1]["custName"] = "Beta";
      tCust.Rows[2]["custName"] = "Omega";
      
      // For each customer, create five rows in the Orders table.
      for(int i = 1; i < 4; i++)
      {
         for(int j = 1; j < 6; j++)
         {
            newRow2 = tOrders.NewRow();
            newRow2["CustID"]= i;
            newRow2["orderDate"]= new DateTime(2001, i, j * 2);
            newRow2["OrderAmount"] = i * 10 + j  * .1;
            // Add the row to the Orders table.
            tOrders.Rows.Add(newRow2);
         }
      }
   }
 }

Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Globalization
Imports System.Windows.Forms

Public Class Form1
   Inherits Form

   Private components As Container
   Private button1 As Button
   Private button2 As Button
   Private button3 As Button
   Private button4 As Button
   Private text1 As TextBox
   Private text2 As TextBox
   Private text3 As TextBox

   Private bmCustomers As BindingManagerBase
   Private bmOrders As BindingManagerBase
   Private ds As DataSet
   Private DateTimePicker1 As DateTimePicker
   
   Public Sub New
      ' Required for Windows Form Designer support.
      InitializeComponent
      ' Call SetUp to bind the controls.
      SetUp
   End Sub

   Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
      If disposing Then
         If (components IsNot Nothing) Then
            components.Dispose()
         End If
      End If
      MyBase.Dispose(disposing)
    End Sub


   Private Sub InitializeComponent
      ' Create the form and its controls.
      With Me
         .components = New Container
         .button1 = New Button
         .button2 = New Button
         .button3 = New Button
         .button4 = New Button
         .text1 = New TextBox
         .text2 = New TextBox
         .text3 = New TextBox

         .DateTimePicker1 = New DateTimePicker
         
         .Text = "Binding Sample"
         .ClientSize = New Size(450, 200)

         With .button1
            .Location = New Point(24, 16)
            .Size = New Size(64, 24)
            .Text = "<"
            AddHandler button1.click, AddressOf button1_Click
         End With
         
         
         With .button2
            .Location = New Point(90, 16)
            .Size = New Size(64, 24)
            .Text = ">"
            AddHandler button2.click, AddressOf button2_Click
         End With
         
         With .button3
            .Location = New Point(90, 100)
            .Size = New Size(64, 24)
            .Text = ">"
            AddHandler button3.click, AddressOf button3_Click
         End With

         With .button4
            .Location = New Point(150, 100)
            .Size = New Size(64, 24)
            .Text = ">"
            AddHandler button4.click, AddressOf button4_Click
         End With

         With .text1
            .Location = New Point(24, 50)
            .Size = New Size(150, 24)
         End With

         With .text2
            .Location = New Point(190, 50)
            .Size = New Size(150, 24)
         End With

         With .text3
            .Location = New Point(290, 150)
            .Size = New Size(150, 24)
         End With

            With .DateTimePicker1
               .Location = New Point(90, 150)
               .Size = New Size(200, 800)
            End With

            With .Controls
            .Add(button1)
            .Add(button2)
            .Add(button3)
            .Add(button4)
            .Add(text1)
            .Add(text2)
            .Add(text3)
            .Add(DateTimePicker1)
            End With
      End With
   End Sub
      
   Public Shared Sub Main
      Application.Run(new Form1)
   End Sub

   Private Sub SetUp
      ' Create a DataSet with two tables and one relation.
      MakeDataSet
      BindControls
   End Sub

   Private Sub BindControls
      ' Create two Binding objects for the first two TextBox
      ' controls. The data-bound property for both controls
      ' is the Text property.  The data source is a DataSet
      ' (ds). The data member is the 
      ' TableName.ColumnName" string.

      text1.DataBindings.Add(New _
         Binding("Text", ds, "customers.custName"))
      text2.DataBindings.Add(New _
         Binding("Text", ds, "customers.custID"))
      ' Bind the DateTimePicker control by adding a new Binding.
      ' The data member of the DateTimePicker is a
      ' TableName.RelationName.ColumnName string
      DateTimePicker1.DataBindings.Add(New _
         Binding("Value", ds, "customers.CustToOrders.OrderDate"))
      ' Add event delegates for the Parse and Format events to a
      ' new Binding object, and add the object to the third
      ' TextBox control's BindingsCollection. The delegates
      ' must be added before adding the Binding to the
      ' collection; otherwise, no formatting occurs until
      ' the Current object of the BindingManagerBase for
      ' the data source changes.
      Dim b As Binding = New _
         Binding("Text", ds, "customers.custToOrders.OrderAmount")
      AddHandler b.Parse, AddressOf CurrencyStringToDecimal
      AddHandler b.Format, AddressOf DecimalToCurrencyString
      text3.DataBindings.Add(b)
      
         ' Get the BindingManagerBase for the Customers table.
         bmCustomers = Me.BindingContext(ds, "Customers")

         ' Get the BindingManagerBase for the Orders table using the
         ' RelationName.
         bmOrders = Me.BindingContext(ds, "customers.CustToOrders")
   End Sub

   Private Sub DecimalToCurrencyString(sender As Object, cevent As ConvertEventArgs)
      ' This method is the Format event handler. Whenever the 
      ' control displays a new value, the value is converted from 
      ' its native Decimal type to a string. The ToString method 
      ' then formats the value as a Currency, by using the 
      ' formatting character "c".

      ' The application can only convert to string type. 
   
      If cevent.DesiredType IsNot GetType(String) Then
         Exit Sub
      End If 
   
      cevent.Value = CType(cevent.Value, decimal).ToString("c")
   End Sub

   Private Sub CurrencyStringToDecimal(sender As Object, cevent As ConvertEventArgs)
      ' This method is the Parse event handler. The Parse event 
      ' occurs whenever the displayed value changes. The static 
      ' ToDecimal method of the Convert class converts the 
      ' value back to its native Decimal type.

      ' Can only convert to decimal type.
      If cevent.DesiredType IsNot GetType(decimal) Then
         Exit Sub
      End If

      cevent.Value = Decimal.Parse(cevent.Value.ToString, _
      NumberStyles.Currency, nothing)
      
      ' To see that no precision is lost, print the unformatted 
      ' value. For example, changing a value to "10.0001" 
      ' causes the control to display "10.00", but the 
      ' unformatted value remains "10.0001".
      Console.WriteLine(cevent.Value)
   End Sub

   Private Sub button1_Click(sender As Object, e As System.EventArgs)
      ' Go to the previous item in the Customer list.
      bmCustomers.Position -= 1
   End Sub

   Private Sub button2_Click(sender As Object, e As System.EventArgs)
      ' Go to the next item in the Customer list.
      bmCustomers.Position += 1
   End Sub

   Private Sub button3_Click(sender As Object, e As System.EventArgs)
      ' Go to the previous item in the Order list.
      bmOrders.Position -= 1
   End Sub

   Private Sub button4_Click(sender As Object, e As System.EventArgs)
      ' Go to the next item in the Orders list.
      bmOrders.Position += 1
   End Sub

   ' Creates a DataSet with two tables and populates it.
   Private Sub MakeDataSet
      ' Create a DataSet.
      ds = New DataSet("myDataSet")

      ' Creates two DataTables.
      Dim tCust As DataTable = New DataTable("Customers")
      Dim tOrders As DataTable = New DataTable("Orders")

      ' Create two columns, and add them to the first table.
      Dim cCustID As DataColumn = New DataColumn("CustID", _
      System.Type.GetType("System.Int32"))
      Dim cCustName As DataColumn = New DataColumn("CustName")
      tCust.Columns.Add(cCustID)
      tCust.Columns.Add(cCustName)

      ' Create three columns, and add them to the second table.
      Dim cID As DataColumn = _
         New DataColumn("CustID", System.Type.GetType("System.Int32"))
      Dim cOrderDate As DataColumn = _
         New DataColumn("orderDate", System.Type.GetType("System.DateTime"))
      Dim cOrderAmount As DataColumn = _
         New DataColumn("OrderAmount", System.Type.GetType("System.Decimal"))
      tOrders.Columns.Add(cOrderAmount)
      tOrders.Columns.Add(cID)
      tOrders.Columns.Add(cOrderDate)

      ' Add the tables to the DataSet.
      ds.Tables.Add(tCust)
      ds.Tables.Add(tOrders)

      ' Create a DataRelation, and add it to the DataSet.
      Dim dr As DataRelation = New _
         DataRelation("custToOrders", cCustID, cID)
      ds.Relations.Add(dr)
      
      ' Populate the tables. For each customer and orders,
      ' create two DataRow variables.
      Dim newRow1 As DataRow
      Dim newRow2 As DataRow

         ' Create three customers in the Customers Table.
         Dim i As Integer
         For i = 1 to 3
            newRow1 = tCust.NewRow
            newRow1("custID") = i
            ' Adds the row to the Customers table.
            tCust.Rows.Add(newRow1)
         Next

         ' Give each customer a distinct name.
         tCust.Rows(0)("custName") = "Alpha"
         tCust.Rows(1)("custName") = "Beta"
         tCust.Rows(2)("custName") = "Omega"

         ' For each customer, create five rows in the Orders table.
         Dim j As Integer
         For i = 1 to 3
         For j = 1 to 5
            newRow2 = tOrders.NewRow
            newRow2("CustID") = i
            newRow2("orderDate") = New DateTime(2001, i, j * 2)
            newRow2("OrderAmount") = i * 10 + j * .1
            ' Add the row to the Orders table.
            tOrders.Rows.Add(newRow2)
         Next
         Next
   End Sub
End Class

Remarques

Utilisez la classe Binding pour créer et maintenir une liaison simple entre la propriété d’un contrôle et la propriété d’un objet, ou la propriété de l’objet actif dans une liste d’objets.

Par exemple, vous pouvez lier la propriété Text d’un contrôle TextBox à la propriété FirstName d’un objet Customer. Par exemple, vous pouvez lier la propriété Text d’un contrôle TextBox à la propriété FirstName d’un DataTable qui contient des clients.

La classe Binding vous permet également de mettre en forme des valeurs pour l’affichage via l’événement Format et de récupérer des valeurs mises en forme via l’événement Parse.

Lors de la construction d’une instance Binding avec Binding constructeur, vous devez spécifier trois éléments :

• Nom de la propriété de contrôle à lier.

• Source de données.

• Chemin de navigation qui se résout en liste ou propriété dans la source de données. Le chemin de navigation est également utilisé pour créer la propriété BindingMemberInfo de l’objet.

Tout d’abord, vous devez spécifier le nom de la propriété de contrôle à laquelle vous souhaitez lier les données. Par exemple, pour afficher des données dans un contrôle TextBox, spécifiez la propriété Text.

Ensuite, vous pouvez spécifier une instance de l’une des classes du tableau suivant comme source de données.

Description	Exemple C#
Toute classe qui implémente IBindingList ou ITypedList. Il s’agit notamment des éléments suivants : DataSet, DataTable, DataViewou DataViewManager.	DataSet ds = new DataSet("myDataSet");
Toute classe qui implémente IList pour créer une collection indexée d’objets. La collection doit être créée et remplie avant de créer le Binding. Les objets de la liste doivent tous être du même type ; sinon, une exception est levée.	ArrayList ar1 = new ArrayList; Customer1 cust1 = new Customer("Louis"); ar1.Add(cust1);
Un IList fortement typé d’objets fortement typés	Customer [] custList = new Customer[3];

Troisièmement, vous devez spécifier le chemin de navigation, qui peut être une chaîne vide («  »), un nom de propriété unique ou une hiérarchie délimitée par un point de noms. Si vous définissez le chemin de navigation sur une chaîne vide, la méthode ToString sera appelée sur l’objet source de données sous-jacent.

Si la source de données est un DataTable, qui peut contenir plusieurs objets DataColumn, le chemin de navigation doit être utilisé pour résoudre une colonne spécifique.

Note

Lorsque la source de données est un DataSet, DataViewManagerou DataTable, vous êtes en fait en liaison à un DataView. Par conséquent, les lignes liées sont en fait DataRowView objets.

Un chemin de navigation délimité par un point est requis lorsque la source de données est définie sur un objet qui contient plusieurs objets DataTable (tels qu’un DataSet ou un DataViewManager). Vous pouvez également utiliser un chemin de navigation délimité par un point lorsque vous liez à un objet dont les propriétés retournent des références à d’autres objets (par exemple, une classe avec des propriétés qui retournent d’autres objets de classe). Par exemple, les chemins de navigation suivants décrivent tous les champs de données valides :

• « Size.Height »

• « Suppliers.CompanyName »

• « Regions.regionsToCustomers.CustomerFirstName »

• « Regions.regionsToCustomers.customersToOrders.ordersToDetails.Quantity »

Chaque membre du chemin d’accès peut retourner une propriété qui se résout en une seule valeur (par exemple, un entier) ou une liste de valeurs (par exemple, un tableau de chaînes). Bien que chaque membre du chemin d’accès puisse être une liste ou une propriété, le membre final doit être résolu en propriété. Chaque membre s’appuie sur le membre précédent : « Size.Height » est résolu en propriété Height pour la Sizeactuelle ; « Regions.regionsToCustomers.CustomerFirstName » se résout par le prénom du client actuel, où le client est l’un des clients de la région actuelle.

Une DataRelation retourne une liste de valeurs en liant un DataTable à une deuxième DataTable dans un DataSet. Si le DataSet contient des objets DataRelation, vous pouvez spécifier le membre de données en tant que TableName suivi d’un RelationName, puis d’un ColumnName. Par exemple, si le DataTable nommé « Fournisseurs » contient un DataRelation nommé « suppliers2products », le membre de données peut être « Suppliers.suppliers2products.ProductName ».

La source de données peut se composer d’un ensemble de classes associées. Par exemple, imaginez un ensemble de classes qui cataloguent les systèmes solaires. La classe nommée System contient une propriété nommée Stars qui retourne une collection d’objets Star. Chaque objet Star a des propriétés Name et Mass, ainsi qu’une propriété Planets qui retourne une collection d’objets Planet. Dans ce système, chaque planète a également des propriétés Mass et Name. Chaque objet Planet possède une propriété Moons qui retourne une collection d’objets Moon, chacune ayant également des propriétés Name et Mass. Si vous spécifiez un objet System comme source de données, vous pouvez spécifier l’un des éléments suivants en tant que membre de données :

• « Stars.Name »

• « Stars.Mass »

• « Stars.Planets.Name »

• « Stars.Planets.Mass »

• « Stars.Planets.Moons.Name »

• « Stars.Planets.Moons.Mass »

Les contrôles qui peuvent être liés de manière simple présentent une collection d’objets Binding dans un ControlBindingsCollection, auquel vous pouvez accéder via la propriété DataBindings du contrôle. Vous ajoutez un Binding à la collection en appelant la méthode Add, en liant ainsi une propriété du contrôle à une propriété d’un objet (ou à une propriété de l’objet actif dans une liste).

Vous pouvez facilement lier à n’importe quel objet dérivé de la classe System.Windows.Forms.Control, par exemple les contrôles Windows suivants :

• Button

• CheckBox

• CheckedListBox

• ComboBox

• DateTimePicker

• DomainUpDown

• GroupBox

• HScrollBar

• Label

• LinkLabel

• ListBox

• ListView

• MonthCalendar

• NumericUpDown

• PictureBox

• ProgressBar

• RadioButton

• RichTextBox

• ScrollBar

• StatusBar

• TextBox

• TreeView

• VScrollBar

Note

Seule la propriété SelectedValue du ComboBox, CheckedListBoxet le contrôle ListBox est simple.

La classe BindingManagerBase est une classe abstraite qui gère tous les objets Binding pour une source de données et un membre de données particulier. Les classes dérivées de BindingManagerBase sont les classes CurrencyManager et PropertyManager. La façon dont une Binding est gérée dépend du fait que la Binding est une liaison de liste ou une liaison de propriété. Par exemple, s’il s’agit d’une liaison de liste, vous pouvez utiliser la BindingManagerBase pour spécifier un Position dans la liste ; le Positiondétermine donc quel élément (hors de tous les éléments de la liste) est réellement lié à un contrôle. Pour retourner la BindingManagerBaseappropriée, utilisez la BindingContext.

Pour ajouter une nouvelle ligne à un ensemble de contrôles liés au même DataSource, utilisez la méthode AddNew de la classe BindingManagerBase. Utilisez la propriété Item[] de la classe BindingContext pour retourner la CurrencyManagerappropriée. Pour échapper à l’ajout de la nouvelle ligne, utilisez la méthode CancelCurrentEdit.

Constructeurs

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Initialise une nouvelle instance de la classe Binding avec la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme avec la chaîne de format spécifiée ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; active la mise en forme avec la chaîne de format spécifiée ; définit la propriété sur la valeur spécifiée lorsqu’un DBNull est retourné à partir de la source de données ; et définit le fournisseur de format spécifié.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme avec la chaîne de format spécifiée ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; et définit la propriété sur la valeur spécifiée lorsqu’un DBNull est retourné à partir de la source de données.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle indiquée au membre de données spécifié de la source de données spécifiée. Vous pouvez éventuellement activer la mise en forme, propager des valeurs à la source de données en fonction du paramètre de mise à jour spécifié et définir la propriété sur la valeur spécifiée lorsqu’une DBNull est retournée à partir de la source de données.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme et propage les valeurs vers la source de données en fonction du paramètre de mise à jour spécifié.
Binding(String, Object, String, Boolean)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle indiquée au membre de données spécifié de la source de données et permet éventuellement d’appliquer la mise en forme.
Binding(String, Object, String)	Initialise une nouvelle instance de la classe Binding qui lie simple la propriété de contrôle indiquée au membre de données spécifié de la source de données.

Propriétés

BindableComponent	Obtient le contrôle auquel le Binding est associé.
BindingManagerBase	Obtient la BindingManagerBase pour cette Binding.
BindingMemberInfo	Obtient un objet qui contient des informations sur cette liaison en fonction du paramètre dataMember dans le constructeur Binding.
Control	Obtient le contrôle auquel appartient la liaison.
ControlUpdateMode	Obtient ou définit lorsque les modifications apportées à la source de données sont propagées à la propriété de contrôle liée.
DataSource	Obtient la source de données de cette liaison.
DataSourceNullValue	Obtient ou définit la valeur à stocker dans la source de données si la valeur du contrôle est null ou vide.
DataSourceUpdateMode	Obtient ou définit une valeur qui indique quand les modifications apportées à la propriété de contrôle liée sont propagées à la source de données.
FormatInfo	Obtient ou définit le IFormatProvider qui fournit un comportement de mise en forme personnalisé.
FormatString	Obtient ou définit les caractères spécificateur de format qui indiquent la façon dont une valeur doit être affichée.
FormattingEnabled	Obtient ou définit une valeur indiquant si la conversion de type et la mise en forme sont appliquées aux données de propriété de contrôle.
IsBinding	Obtient une valeur indiquant si la liaison est active.
NullValue	Obtient ou définit la Object à définir comme propriété de contrôle lorsque la source de données contient une valeur DBNull.
PropertyName	Obtient le nom de la propriété liée aux données du contrôle.

Méthodes

Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
OnBindingComplete(BindingCompleteEventArgs)	Déclenche l’événement BindingComplete.
OnFormat(ConvertEventArgs)	Déclenche l’événement Format.
OnParse(ConvertEventArgs)	Déclenche l’événement Parse.
ReadValue()	Définit la propriété de contrôle sur la valeur lue à partir de la source de données.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)
WriteValue()	Lit la valeur actuelle de la propriété de contrôle et l’écrit dans la source de données.

Événements

BindingComplete	Se produit lorsque la propriété FormattingEnabled est définie sur true et qu’une opération de liaison est terminée, par exemple lorsque les données sont envoyées du contrôle à la source de données ou inversement.
Format	Se produit lorsque la propriété d’un contrôle est liée à une valeur de données.
Parse	Se produit lorsque la valeur d’un contrôle lié aux données change.

Voir aussi

• BindingContext
• BindingManagerBase
• ComboBox
• DataGrid