Binding Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Rappresenta l'associazione semplice tra il valore della proprietà di un oggetto e il valore della proprietà di un controllo.
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- Ereditarietà
-
Binding
- Attributi
Esempio
Nell'esempio di codice seguente viene creato un Windows Form con diversi controlli che illustrano un data binding semplice. Nell'esempio viene creato un DataSet oggetto con due tabelle denominate Customers e Orderse un DataRelation oggetto denominato custToOrders. Quattro controlli (a DateTimePicker e tre TextBox controlli) sono dati associati a colonne nelle tabelle. Per ogni controllo, nell'esempio viene creato e aggiunto un Binding oggetto al controllo tramite la DataBindings proprietà . Nell'esempio viene restituito un oggetto BindingManagerBase per ogni tabella tramite l'oggetto del BindingContextform. Quattro Button controlli incrementa o decrementa la Position proprietà sugli BindingManagerBase oggetti .
#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
Commenti
Utilizzare la Binding classe per creare e gestire un'associazione semplice tra la proprietà di un controllo e la proprietà di un oggetto oppure la proprietà dell'oggetto corrente in un elenco di oggetti.
Come esempio del primo caso, è possibile associare la Text proprietà di un TextBox controllo alla FirstName proprietà di un Customer oggetto . Come esempio del secondo caso, è possibile associare la Text proprietà di un TextBox controllo alla FirstName proprietà di un DataTable oggetto che contiene i clienti.
La Binding classe consente inoltre di formattare i valori per la visualizzazione tramite l'evento Format e di recuperare i valori formattati tramite l'evento Parse .
Quando si costruisce un'istanza Binding con Binding il costruttore, è necessario specificare tre elementi:
Nome della proprietà del controllo a cui eseguire l'associazione.
Origine dati.
Percorso di spostamento che si risolve in un elenco o una proprietà nell'origine dati. Il percorso di spostamento viene usato anche per creare la proprietà dell'oggetto BindingMemberInfo .
Prima di tutto, è necessario specificare il nome della proprietà del controllo a cui si desidera associare i dati. Ad esempio, per visualizzare i dati in un TextBox controllo, specificare la Text proprietà .
In secondo luogo, è possibile specificare un'istanza di una delle classi nella tabella seguente come origine dati.
| Descrizione | Esempio di C# |
|---|---|
| Qualsiasi classe che implementa IBindingList o ITypedList. Sono inclusi i seguenti: DataSet, DataTable, DataViewo DataViewManager. | DataSet ds = new DataSet("myDataSet"); |
| Qualsiasi classe che implementa IList per creare una raccolta indicizzata di oggetti . La raccolta deve essere creata e compilata prima di creare .Binding Gli oggetti nell'elenco devono essere tutti dello stesso tipo; in caso contrario, verrà generata un'eccezione. | ArrayList ar1 = new ArrayList; Customer1 cust1 = new Customer("Louis"); ar1.Add(cust1); |
| Oggetto fortemente tipizzato di oggetti fortemente tipizzati IList | Customer [] custList = new Customer[3]; |
In terzo luogo, è necessario specificare il percorso di spostamento, che può essere una stringa vuota (""), un singolo nome di proprietà o una gerarchia delimitata da punti di nomi. Se si imposta il percorso di spostamento su una stringa vuota, il ToString metodo verrà chiamato sull'oggetto origine dati sottostante.
Se l'origine dati è un DataTableoggetto , che può contenere più DataColumn oggetti, è necessario usare il percorso di spostamento per risolvere una colonna specifica.
Annotazioni
Quando l'origine dati è un DataSetoggetto , DataViewManagero DataTable, si esegue effettivamente l'associazione a un oggetto DataView. Di conseguenza, le righe associate sono effettivamente DataRowView oggetti .
Un percorso di spostamento delimitato da punti è necessario quando l'origine dati è impostata su un oggetto che contiene più DataTable oggetti , ad esempio o DataSetDataViewManager. È anche possibile utilizzare un percorso di spostamento delimitato da punti quando si esegue l'associazione a un oggetto le cui proprietà restituiscono riferimenti ad altri oggetti, ad esempio una classe con proprietà che restituiscono altri oggetti classe. Ad esempio, i percorsi di spostamento seguenti descrivono tutti i campi dati validi:
"Size.Height"
"Suppliers.CompanyName"
"Regions.regionsToCustomers.CustomerFirstName"
"Regions.regionsToCustomers.customersToOrders.ordersToDetails.Quantity"
Ogni membro del percorso può restituire una proprietà che viene risolta in un singolo valore (ad esempio un numero intero) o un elenco di valori ,ad esempio una matrice di stringhe. Anche se ogni membro nel percorso può essere un elenco o una proprietà, il membro finale deve essere risolto in una proprietà. Ogni membro si basa sul membro precedente: "Size.Height" viene risolto nella Height proprietà per l'oggetto corrente Size. "Regions.regionsToCustomers.CustomerFirstName" viene risolto nel nome del cliente corrente, dove il cliente è uno dei clienti per l'area corrente.
Un DataRelation oggetto restituisce un elenco di valori collegando uno DataTable a un secondo DataTable in un oggetto DataSet. Se contiene DataSetDataRelation oggetti, è possibile specificare il membro dati come TableName seguito da un RelationNameoggetto e quindi un oggetto ColumnName. Ad esempio, se il DataTable nome "Suppliers" contiene un DataRelation nome "suppliers2products", il membro dati potrebbe essere "Suppliers.suppliers2products.ProductName".
L'origine dati può essere costituita da un set di classi correlate. Si supponga, ad esempio, di un set di classi che cataloga i sistemi solari. La classe denominata System contiene una proprietà denominata Stars che restituisce una raccolta di Star oggetti. Ogni Star oggetto ha Name proprietà e Mass , nonché una Planets proprietà che restituisce una raccolta di Planet oggetti . In questo sistema, ogni pianeta ha Mass anche proprietà e Name . Ogni Planet oggetto dispone inoltre di una Moons proprietà che restituisce una raccolta di Moon oggetti, ognuno dei quali ha Name anche proprietà e Mass . Se si specifica un System oggetto come origine dati, è possibile specificare uno dei seguenti elementi come membro dati:
"Stars.Name"
"Stars.Mass"
"Stars.Planets.Name"
"Stars.Planets.Mass"
"Stars.Planets.Moons.Name"
"Stars.Planets.Moons.Mass"
I controlli che possono essere associati a semplici funzionalità in una raccolta di Binding oggetti in un ControlBindingsCollectionoggetto , a cui è possibile accedere tramite la proprietà del DataBindings controllo. Si aggiunge un oggetto Binding all'insieme chiamando il Add metodo , associando così una proprietà del controllo a una proprietà di un oggetto (o a una proprietà dell'oggetto corrente in un elenco).
È possibile eseguire il binding semplice a qualsiasi oggetto che deriva dalla System.Windows.Forms.Control classe , ad esempio i controlli Windows seguenti:
Annotazioni
Solo la SelectedValue proprietà del ComboBoxcontrollo , CheckedListBoxe ListBox è associata in modo semplice.
La BindingManagerBase classe è una classe astratta che gestisce tutti gli Binding oggetti per un'origine dati e un membro dati specifici. Le classi che derivano da BindingManagerBase sono e CurrencyManager le PropertyManager classi . La modalità di gestione di un Binding oggetto dipende dal fatto che sia un'associazione Binding di elenco o un'associazione di proprietà. Ad esempio, se si tratta di un'associazione di elenco, è possibile utilizzare BindingManagerBase per specificare un Position oggetto nell'elenco. PositionPertanto, determina quale elemento (fuori tutti gli elementi dell'elenco) è effettivamente associato a un controllo. Per restituire l'oggetto appropriatoBindingManagerBase, usare .BindingContext
Per aggiungere una nuova riga a un set di controlli associati allo stesso DataSourceoggetto , utilizzare il AddNew metodo della BindingManagerBase classe . Utilizzare la Item[] proprietà della BindingContext classe per restituire l'oggetto appropriato CurrencyManager. Per eseguire l'escape dell'aggiunta della nuova riga, utilizzare il CancelCurrentEdit metodo .
Costruttori
| Nome | Descrizione |
|---|---|
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Inizializza una nuova istanza della Binding classe con la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione con la stringa di formato specificata; propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata; abilita la formattazione con la stringa di formato specificata; imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati e imposta il provider di formato specificato. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione con la stringa di formato specificata; propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata; e imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo indicato al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione, propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode) |
Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione e propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata. |
| Binding(String, Object, String, Boolean) |
Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo indicato al membro dati specificato dell'origine dati e, facoltativamente, consente l'applicazione della formattazione. |
| Binding(String, Object, String) |
Inizializza una nuova istanza della Binding classe che associa in modo semplice la proprietà del controllo indicato al membro dati specificato dell'origine dati. |
Proprietà
| Nome | Descrizione |
|---|---|
| BindableComponent |
Ottiene il controllo Binding a cui è associato . |
| BindingManagerBase |
Ottiene l'oggetto per l'oggetto BindingManagerBaseBinding. |
| BindingMemberInfo |
Ottiene un oggetto che contiene informazioni su questa associazione in base al |
| Control |
Ottiene il controllo a cui appartiene l'associazione. |
| ControlUpdateMode |
Ottiene o imposta quando le modifiche all'origine dati vengono propagate alla proprietà del controllo associato. |
| DataSource |
Ottiene l'origine dati per questa associazione. |
| DataSourceNullValue |
Ottiene o imposta il valore da archiviare nell'origine dati se il valore del controllo è |
| DataSourceUpdateMode |
Ottiene o imposta un valore che indica quando le modifiche apportate alla proprietà del controllo associato vengono propagate all'origine dati. |
| FormatInfo |
Ottiene o imposta l'oggetto IFormatProvider che fornisce un comportamento di formattazione personalizzato. |
| FormatString |
Ottiene o imposta i caratteri dell'identificatore di formato che indicano la modalità di visualizzazione di un valore. |
| FormattingEnabled |
Ottiene o imposta un valore che indica se la conversione e la formattazione dei tipi vengono applicate ai dati della proprietà del controllo. |
| IsBinding |
Ottiene un valore che indica se l'associazione è attiva. |
| NullValue |
Ottiene o imposta l'oggetto Object da impostare come proprietà del controllo quando l'origine dati contiene un DBNull valore. |
| PropertyName |
Ottiene il nome della proprietà associata a dati del controllo. |
Metodi
| Nome | Descrizione |
|---|---|
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| OnBindingComplete(BindingCompleteEventArgs) |
Genera l'evento BindingComplete. |
| OnFormat(ConvertEventArgs) |
Genera l'evento Format. |
| OnParse(ConvertEventArgs) |
Genera l'evento Parse. |
| ReadValue() |
Imposta la proprietà del controllo sul valore letto dall'origine dati. |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| WriteValue() |
Legge il valore corrente dalla proprietà del controllo e lo scrive nell'origine dati. |
Eventi
| Nome | Descrizione |
|---|---|
| BindingComplete |
Si verifica quando la FormattingEnabled proprietà è impostata su |
| Format |
Si verifica quando la proprietà di un controllo è associata a un valore di dati. |
| Parse |
Si verifica quando cambia il valore di un controllo associato a dati. |
