Binding Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Représente la liaison simple entre la valeur de propriété d'un objet et la valeur de propriété du 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 = classPublic Class Binding- Héritage
-
Binding
- Attributs
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 un DataSet avec deux tables nommées Customers et Orders, et un DataRelation nommé custToOrders. Quatre contrôles (un DateTimePicker et trois TextBox contrôles) sont des données liées aux colonnes des tables. Pour chaque contrôle, l’exemple crée et ajoute un Binding au contrôle via la DataBindings propriété . L’exemple retourne un BindingManagerBase pour chaque table via le formulaire BindingContext. Quatre Button contrôles incrémentent ou décrémentent la Position propriété sur les BindingManagerBase objets.
#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 Binding classe pour créer et gérer 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 actuel dans une liste d’objets.
À titre d’exemple de premier cas, vous pouvez lier la Text propriété d’un TextBox contrôle à la FirstName propriété d’un Customer objet . Comme exemple de deuxième cas, vous pouvez lier la Text propriété d’un TextBox contrôle à la FirstName propriété d’un DataTable qui contient des clients.
La Binding classe vous permet également de mettre en forme des valeurs à afficher 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’un Binding instance avec Binding un 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 est résolu en liste ou propriété dans la source de données. Le chemin de navigation est également utilisé pour créer la propriété de l’objet BindingMemberInfo .
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 TextBox contrôle, spécifiez la Text propriété .
Deuxièmement, vous pouvez spécifier une instance de l’une des classes du tableau suivant en tant que source de données.
| Description | Exemple en code 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); |
| Objet fortement typé IList 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 de noms délimitée par des points. Si vous définissez le chemin de navigation sur une chaîne vide, la ToString méthode est appelée sur l’objet de source de données sous-jacent.
Si la source de données est un DataTable, qui peut contenir plusieurs DataColumn objets, le chemin de navigation doit être utilisé pour résoudre une colonne spécifique.
Notes
Lorsque la source de données est , DataSetDataViewManagerou DataTable, vous êtes en fait lié à un DataView. Par conséquent, les lignes liées sont en fait DataRowView des objets.
Un chemin de navigation délimité par une période est requis lorsque la source de données est définie sur un objet qui contient plusieurs DataTable objets (par exemple, ou DataSetDataViewManager). Vous pouvez également utiliser un chemin de navigation délimité par des points lorsque vous liez à un objet dont les propriétés renvoient des références à d’autres objets (par exemple, une classe avec des propriétés qui renvoient d’autres objets de classe). Par exemple, les chemins de navigation suivants décrivent tous des 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 valeur unique (comme 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 une propriété. Chaque membre s’appuie sur le membre précédent : « Size.Height » est résolu en propriété Height pour le actuel Size; « Regions.regionsToCustomers.CustomerFirstName » correspond au prénom du client actuel, où le client est l’un des clients de la région actuelle.
Retourne DataRelation une liste de valeurs en liant une DataTable à une seconde DataTable dans un DataSet. Si contient des DataSet objets, vous pouvez spécifier le membre de données sous la forme d’un TableName suivi d’un RelationName, puis d’un ColumnName.DataRelation Par exemple, si le DataTable nommé « Suppliers » 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 catalogue les systèmes solaires. La classe nommée System contient une propriété nommée Stars qui renvoie une collection d’objets Star . Chaque Star objet a Name des propriétés et Mass , ainsi qu’une Planets propriété qui renvoie une collection d’objets Planet . Dans ce système, chaque planète a Mass également des propriétés et Name . Chaque Planet objet a en outre une Moons propriété qui renvoie une collection d’objets Moon , chacun d’entre eux ayant Name également des propriétés et Mass . Si vous spécifiez un System objet comme source de données, vous pouvez spécifier l’un des éléments suivants comme 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é du DataBindings contrôle. Vous ajoutez un Binding à la collection en appelant la Add méthode, ce qui lie 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 lier simplement à n’importe quel objet qui dérive de la System.Windows.Forms.Control classe, par exemple, les contrôles Windows suivants :
Notes
Seule la SelectedValue propriété du ComboBoxcontrôle , CheckedListBoxet ListBox est liée simple.
La BindingManagerBase classe est une classe abstraite qui gère tous les objets d’une Binding source de données et d’un membre de données particuliers. Les classes qui dérivent sont BindingManagerBase les CurrencyManager classes et .PropertyManager La façon dont un Binding est géré varie selon qu’il s’agit Binding d’une liaison de liste ou d’une liaison de propriété. Par exemple, s’il s’agit d’une liaison de liste, vous pouvez utiliser pour BindingManagerBase spécifier un Position dans la liste ; par conséquent, le Position, détermine quel élément (parmi tous les éléments de la liste) est réellement lié à un contrôle. Pour retourner le approprié BindingManagerBase, utilisez .BindingContext
Pour ajouter une nouvelle ligne à un ensemble de contrôles liés au même DataSource, utilisez la AddNew méthode de la BindingManagerBase classe . Utilisez la Item[] propriété de la BindingContext classe pour renvoyer le approprié CurrencyManager. Pour échapper à l’ajout de la nouvelle ligne, utilisez la CancelCurrentEdit méthode .
Constructeurs
| Binding(String, Object, String) |
Initialise une nouvelle instance de la classe Binding 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. |
| Binding(String, Object, String, Boolean) |
Initialise une nouvelle instance de la classe Binding 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 l'application de la mise en forme. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode) |
Initialise une nouvelle instance de la classe Binding qui établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiqué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é. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Initialise une nouvelle instance de la classe Binding qui établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiquée. Active éventuellement la mise en forme, propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié et affecte à la propriété la valeur spécifiée lorsqu'un DBNull est retourné à partir de la source de données. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Initialise une nouvelle instance de la classe Binding qui établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiqué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 affecte à la propriété la valeur spécifiée lorsque DBNull est retourné à partir de la source de données. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Initialise une nouvelle instance de la classe Binding avec la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiquée. Active éventuellement la mise en forme avec la chaîne de mise en forme 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 mise en forme spécifiée, affecte à la propriété 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é. |
Propriétés
| BindableComponent |
Obtient le contrôle auquel Binding est associé. |
| BindingManagerBase |
Obtient le BindingManagerBase pour ce Binding. |
| BindingMemberInfo |
Extrait un objet qui contient des informations sur cette liaison par l'intermédiaire du paramètre |
| Control |
Obtient le contrôle auquel cette liaison appartient. |
| ControlUpdateMode |
Obtient ou définit lorsque les modifications à la source de données sont propagées à la propriété du contrôle lié. |
| DataSource |
Obtient la source de données pour cette liaison. |
| DataSourceNullValue |
Obtient ou définit la valeur à stocker dans la source de données si la valeur de contrôle est |
| DataSourceUpdateMode |
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. |
| FormatInfo |
Obtient ou définit IFormatProvider qui fournit le comportement de mise en forme personnalisé. |
| FormatString |
Obtient ou définit les caractères spécificateurs de format qui indiquent comment une valeur doit s'afficher. |
| FormattingEnabled |
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. |
| IsBinding |
Obtient une valeur indiquant si la liaison est active. |
| NullValue |
Obtient ou définit Object à définir comme propriété du 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() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (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() |
Affecte la valeur lue de la source de données à la propriété du contrôle. |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
| WriteValue() |
Lit la valeur actuelle de la propriété du contrôle et l'écrit dans la source de données. |
Événements
| BindingComplete |
Se produit quand la propriété FormattingEnabled a la valeur |
| Format |
Se produit lorsque la propriété du contrôle est liée à une valeur de données. |
| Parse |
Se produit lorsque la valeur d'un contrôle lié aux données est modifiée. |
S’applique à
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour