Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Binding classe

 

Date de publication : novembre 2016

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

Espace de noms:   System.Windows.Forms
Assembly:  System.Windows.Forms (dans System.Windows.Forms.dll)

System.Object
  System.Windows.Forms.Binding

[TypeConverterAttribute(typeof(ListBindingConverter))]
public class Binding

NomDescription
System_CAPS_pubmethodBinding(String, Object, String)

Initialise une nouvelle instance de la Binding classe qui établit une liaison simple de la propriété du contrôle indiquée aux données membres spécifiées de la source de données.

System_CAPS_pubmethodBinding(String, Object, String, Boolean)

Initialise une nouvelle instance de la Binding classe qui lie la propriété du contrôle indiquée aux données membres spécifiées de la source de données et permet éventuellement de mise en forme à appliquer.

System_CAPS_pubmethodBinding(String, Object, String, Boolean, DataSourceUpdateMode)

Initialise une nouvelle instance de la Binding classe qui lie la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée. Active éventuellement la mise en forme et propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié.

System_CAPS_pubmethodBinding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Initialise une nouvelle instance de la Binding classe qui lie la propriété du contrôle indiquée aux données membres spécifiées de la source de données spécifiée. Permet la mise en forme, propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié et définit la propriété spécifiée éventuellement valeur lorsque un DBNull est retourné à partir de la source de données.

System_CAPS_pubmethodBinding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Initialise une nouvelle instance de la Binding classe qui lie la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée. Permet éventuellement de mise en forme avec la chaîne de format ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; et définit la propriété spécifié à la valeur quand un DBNull est retourné à partir de la source de données.

System_CAPS_pubmethodBinding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Initialise une nouvelle instance de la Binding classe avec la propriété du contrôle spécifiée aux données membres spécifiées de la source de données spécifiée. Permet éventuellement de mise en forme avec la chaîne de format ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; permet la mise en forme avec la chaîne de format ; définit la propriété spécifié à la valeur quand un DBNull est retourné à partir de la source de données et définit le fournisseur de format spécifié.

NomDescription
System_CAPS_pubpropertyBindableComponent

Obtient le contrôle de la Binding est associé.

System_CAPS_pubpropertyBindingManagerBase

Obtient le BindingManagerBase pour ce Binding.

System_CAPS_pubpropertyBindingMemberInfo

Obtient un objet qui contient des informations sur la liaison selon les dataMember paramètre dans le Binding constructeur.

System_CAPS_pubpropertyControl

Obtient le contrôle auquel cette liaison appartient.

System_CAPS_pubpropertyControlUpdateMode

Obtient ou définit lorsque les modifications à la source de données sont propagées à la propriété du contrôle lié.

System_CAPS_pubpropertyDataSource

Obtient la source de données pour cette liaison.

System_CAPS_pubpropertyDataSourceNullValue

Obtient ou définit la valeur à stocker dans la source de données si la valeur de contrôle est null ou vide.

System_CAPS_pubpropertyDataSourceUpdateMode

Obtient ou définit une valeur lorsque les modifications de la propriété du contrôle lié sont propagées à la source de données.

System_CAPS_pubpropertyFormatInfo

Obtient ou définit le IFormatProvider qui fournit le comportement de mise en forme personnalisé.

System_CAPS_pubpropertyFormatString

Obtient ou définit les caractères spécificateurs de format qui indiquent comment une valeur doit s'afficher.

System_CAPS_pubpropertyFormattingEnabled

Obtient ou définit une valeur qui indique si la conversion de type et la mise en forme s'appliquent aux données de propriété du contrôle.

System_CAPS_pubpropertyIsBinding

Obtient une valeur indiquant si la liaison est active.

System_CAPS_pubpropertyNullValue

Obtient ou définit le Object à définir comme propriété du contrôle lorsque la source de données contient un DBNull valeur.

System_CAPS_pubpropertyPropertyName

Obtient ou définit le nom de la propriété du contrôle lié aux données.

NomDescription
System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_protmethodOnBindingComplete(BindingCompleteEventArgs)

Déclenche l'événement BindingComplete.

System_CAPS_protmethodOnFormat(ConvertEventArgs)

Déclenche l'événement Format.

System_CAPS_protmethodOnParse(ConvertEventArgs)

Déclenche l'événement Parse.

System_CAPS_pubmethodReadValue()

Affecte la valeur lue de la source de données à la propriété du contrôle.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodWriteValue()

Lit la valeur actuelle de la propriété du contrôle et l'écrit dans la source de données.

NomDescription
System_CAPS_pubeventBindingComplete

Se produit lorsque la FormattingEnabled est définie sur true et une opération de liaison est terminée, comme lorsque des données sont envoyées à partir du contrôle de la source de données ou vice versa

System_CAPS_pubeventFormat

Se produit lorsque la propriété du contrôle est liée à une valeur de données.

System_CAPS_pubeventParse

Se produit lorsque la valeur d'un contrôle lié aux données est modifiée.

Use the T:System.Windows.Forms.Binding class to create and maintain a simple binding between the property of a control and either the property of an object, or the property of the current object in a list of objects.

As an example of the first case, you can bind the P:System.Windows.Forms.Control.Text property of a T:System.Windows.Forms.TextBox control to the FirstName property of a Customer object. As an example of the second case, you can bind the P:System.Windows.Forms.Control.Text property of a T:System.Windows.Forms.TextBox control to the FirstName property of a T:System.Data.DataTable that contains customers.

The T:System.Windows.Forms.Binding class also enables you to format values for display through the E:System.Windows.Forms.Binding.Format event and to retrieve formatted values through the E:System.Windows.Forms.Binding.Parse event.

When constructing a T:System.Windows.Forms.Binding instance with M:System.Windows.Forms.Binding.#ctor(System.String,System.Object,System.String,System.Boolean) constructor, you must specify three items:

  • The name of the control property to bind to.

  • The data source.

  • The navigation path that resolves to a list or property in the data source. The navigation path is also used to create the object's P:System.Windows.Forms.Binding.BindingMemberInfo property.

First, you must specify name of the control property you want to bind the data to. For example, to display data in a T:System.Windows.Forms.TextBox control, specify the P:System.Windows.Forms.TextBoxBase.Text property.

Second, you can specify an instance of any one of the classes in the following table as the data source.

Description

C# example

Any class that implements T:System.ComponentModel.IBindingList or T:System.ComponentModel.ITypedList. These include the following: T:System.Data.DataSet, T:System.Data.DataTable, T:System.Data.DataView, or T:System.Data.DataViewManager.

DataSet ds = new DataSet("myDataSet");

Any class that implements T:System.Collections.IList to create an indexed collection of objects. The collection must be created and filled before creating the T:System.Windows.Forms.Binding. The objects in the list must all be of the same type; otherwise, an exception will be thrown.

ArrayList ar1 = new ArrayList;

Customer1 cust1 = new Customer("Louis");

ar1.Add(cust1);

A strongly typed T:System.Collections.IList of strongly typed objects

Customer [] custList = new Customer[3];

Third, you must specify the navigation path, which can be an empty string (""), a single property name, or a period-delimited hierarchy of names. If you set the navigation path to an empty string, the M:System.Object.ToString method will be called on the underlying data source object.

If the data source is a T:System.Data.DataTable, which can contain multiple T:System.Data.DataColumn objects, the navigation path must be used to resolve to a specific column.

System_CAPS_noteRemarque

When the data source is a T:System.Data.DataSet, T:System.Data.DataViewManager, or T:System.Data.DataTable, you are actually binding to a T:System.Data.DataView. Consequently, the bound rows are actually T:System.Data.DataRowView objects.

A period-delimited navigation path is required when the data source is set to an object that contains multiple T:System.Data.DataTable objects (such as a T:System.Data.DataSet or T:System.Data.DataViewManager). You can also use a period-delimited navigation path when you bind to an object whose properties return references to other objects (such as a class with properties that return other class objects). For example, the following navigation paths all describe valid data fields:

  • "Size.Height"

  • "Suppliers.CompanyName"

  • "Regions.regionsToCustomers.CustomerFirstName"

  • "Regions.regionsToCustomers.customersToOrders.ordersToDetails.Quantity"

Each member of the path can return either a property that resolves to a single value (such as an integer), or a list of values (such as an array of strings). Although each member in the path can be a list or property, the final member must resolve to a property. Each member builds on the previous member: "Size.Height" resolves to the P:System.Drawing.Size.Height property for the current T:System.Drawing.Size; "Regions.regionsToCustomers.CustomerFirstName" resolves to the first name for the current customer, where the customer is one of the customers for the current region.

A T:System.Data.DataRelation returns a list of values by linking one T:System.Data.DataTable to a second T:System.Data.DataTable in a T:System.Data.DataSet. If the T:System.Data.DataSet contains T:System.Data.DataRelation objects, you can specify the data member as a P:System.Data.DataTable.TableName followed by a P:System.Data.DataRelation.RelationName, and then a P:System.Data.DataColumn.ColumnName. For example, if the T:System.Data.DataTable named "Suppliers" contains a T:System.Data.DataRelation named "suppliers2products", the data member could be "Suppliers.suppliers2products.ProductName".

The data source can consist of a set of related classes. For example, imagine a set of classes that catalogs solar systems. The class named System contains a property named Stars that returns a collection of Star objects. Each Star object has Name and Mass properties, as well as a Planets property that returns a collection of Planet objects. In this system, each planet also has Mass and Name properties. Each Planet object further has a Moons property that returns a collection of Moon objects, each of which also has Name and Mass properties. If you specify a System object as the data source, you can specify any of the following as the data member:

  • "Stars.Name"

  • "Stars.Mass"

  • "Stars.Planets.Name"

  • "Stars.Planets.Mass"

  • "Stars.Planets.Moons.Name"

  • "Stars.Planets.Moons.Mass"

Controls that can be simple-bound feature a collection of T:System.Windows.Forms.Binding objects in a T:System.Windows.Forms.ControlBindingsCollection, which you can access through the control's P:System.Windows.Forms.Control.DataBindings property. You add a T:System.Windows.Forms.Binding to the collection by calling the M:System.Windows.Forms.ControlBindingsCollection.Add(System.Windows.Forms.Binding) method, thereby binding a property of the control to a property of an object (or to a property of the current object in a list).

You can simple-bind to any object that derives from the T:System.Windows.Forms.Control class, for example, the following Windows controls:

System_CAPS_noteRemarque

Only the P:System.Windows.Forms.ListControl.SelectedValue property of the T:System.Windows.Forms.ComboBox, T:System.Windows.Forms.CheckedListBox, and T:System.Windows.Forms.ListBox control is simple bound.

The T:System.Windows.Forms.BindingManagerBase class is an abstract class that manages all the T:System.Windows.Forms.Binding objects for a particular data source and data member. Classes that derive from T:System.Windows.Forms.BindingManagerBase are the T:System.Windows.Forms.CurrencyManager and the T:System.Windows.Forms.PropertyManager classes. How a T:System.Windows.Forms.Binding is managed depends on whether the T:System.Windows.Forms.Binding is a list binding or a property binding. For example, if it is a list binding, you can use the T:System.Windows.Forms.BindingManagerBase to specify a P:System.Windows.Forms.BindingManagerBase.Position in the list; the P:System.Windows.Forms.BindingManagerBase.Position, therefore, determines which item (out of all items in the list) is actually bound to a control. To return the appropriate T:System.Windows.Forms.BindingManagerBase, use the T:System.Windows.Forms.BindingContext.

To add a new row to a set of controls bound to the same P:System.Windows.Forms.Binding.DataSource, use the M:System.Windows.Forms.BindingManagerBase.AddNew method of the T:System.Windows.Forms.BindingManagerBase class. Use the P:System.Windows.Forms.BindingContext.Item(System.Object) property of the T:System.Windows.Forms.BindingContext class to return the appropriate T:System.Windows.Forms.CurrencyManager. To escape the addition of the new row, use the M:System.Windows.Forms.CurrencyManager.CancelCurrentEdit method.

The following code example creates a Windows Form with several controls that demonstrate simple data binding. The example creates a T:System.Data.DataSet with two tables named Customers and Orders, and a T:System.Data.DataRelation named custToOrders. Four controls (a T:System.Windows.Forms.DateTimePicker and three T:System.Windows.Forms.TextBox controls) are data bound to columns in the tables. For each control, the example creates and adds a T:System.Windows.Forms.Binding to the control through the P:System.Windows.Forms.Control.DataBindings property. The example returns a T:System.Windows.Forms.BindingManagerBase for each table through the form's T:System.Windows.Forms.BindingContext. Four T:System.Windows.Forms.Button controls increment or decrement the P:System.Windows.Forms.BindingManagerBase.Position property on the T:System.Windows.Forms.BindingManagerBase objects.

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);
         }
      }
   }
 }

.NET Framework
Disponible depuis 1.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: