Binding Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje jednoduchou vazbu mezi hodnotou vlastnosti objektu a hodnotou vlastnosti ovládacího prvku.
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- Dědičnost
-
Binding
- Atributy
Příklady
Následující příklad kódu vytvoří formulář Windows s několika ovládacími prvky, které demonstrují jednoduchou datovou vazbu. V příkladu se vytvoří tabulka DataSet se dvěma tabulkami s názvem Customers a Ordersa s DataRelation názvem custToOrders. Čtyři ovládací prvky (a DateTimePicker a tři TextBox ovládací prvky) jsou data svázaná se sloupci v tabulkách. Příklad pro každý ovládací prvek vytvoří a přidá Binding do ovládacího prvku prostřednictvím DataBindings vlastnosti . Příklad vrátí BindingManagerBase hodnotu pro každou tabulku prostřednictvím formuláře BindingContext. Čtyři Button ovládací prvky inkrementují nebo dekrementují Position vlastnost BindingManagerBase objektů.
#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
Poznámky
Binding Pomocí třídy můžete vytvořit a udržovat jednoduchou vazbu mezi vlastností ovládacího prvku a vlastností objektu nebo vlastností aktuálního objektu v seznamu objektů.
Jako příklad prvního případu můžete svázat Text vlastnost TextBox ovládacího prvku s FirstName vlastností objektu Customer . Jako příklad druhého případu můžete svázat Text vlastnost TextBox ovládacího prvku s FirstName vlastností objektu DataTable , který obsahuje zákazníky.
Třída Binding také umožňuje formátovat hodnoty pro zobrazení prostřednictvím Format události a načítat formátované hodnoty prostřednictvím Parse události.
Při vytváření instance pomocí Binding konstruktoru Binding je nutné zadat tři položky:
Název vlastnosti ovládacího prvku, na který se má vytvořit vazba.
Zdroj dat.
Navigační cesta, která se překládá na seznam nebo vlastnost ve zdroji dat. Navigační cesta slouží také k vytvoření vlastnosti objektu BindingMemberInfo .
Nejprve je nutné zadat název vlastnosti ovládacího prvku, se kterou chcete svázat data. Chcete-li například zobrazit data v ovládacím TextBox prvku, zadejte Text vlastnost .
Za druhé, jako zdroj dat můžete zadat instanci libovolné z tříd v následující tabulce.
| Description | Příklad jazyka C# |
|---|---|
| Libovolná třída, která implementuje IBindingList nebo ITypedList. Patří mezi ně: DataSet, DataTable, DataViewnebo DataViewManager. | DataSet ds = new DataSet("myDataSet"); |
| Libovolná třída, která implementuje IList k vytvoření indexované kolekce objektů. Před vytvořením musí být kolekce vytvořena a vyplněna Binding. Objekty v seznamu musí být stejného typu; jinak dojde k výjimce. | ArrayList ar1 = new ArrayList; Customer1 cust1 = new Customer("Louis"); ar1.Add(cust1); |
| Silné typy IList objektů silného typu | Customer [] custList = new Customer[3]; |
Za třetí je nutné zadat navigační cestu, což může být prázdný řetězec (""), název jedné vlastnosti nebo hierarchie názvů oddělených tečkami. Pokud nastavíte navigační cestu na prázdný řetězec, ToString bude metoda volána u objektu podkladového zdroje dat.
Pokud je DataTablezdrojem dat , který může obsahovat více DataColumn objektů, musí být navigační cesta použita k překladu na konkrétní sloupec.
Poznámka
Pokud je DataSetzdrojem dat , DataViewManagernebo DataTable, ve skutečnosti vytváříte vazbu na .DataView V důsledku toho jsou vázané řádky ve skutečnosti DataRowView objekty.
Pokud je zdroj dat nastavený na objekt, který obsahuje více DataTable objektů (například nebo DataSetDataViewManager), vyžaduje se navigační cesta oddělená tečkami. Navigační cestu oddělenou tečkami můžete použít také při vytváření vazby k objektu, jehož vlastnosti vracejí odkazy na jiné objekty (například na třídu s vlastnostmi vracející jiné objekty třídy). Například následující navigační cesty popisují platná datová pole:
"Size.Height"
"Suppliers.CompanyName"
Regions.regionsToCustomers.CustomerFirstName
"Regions.regionsToCustomers.customersToOrders.ordersToDetails.Quantity"
Každý člen cesty může vrátit buď vlastnost, která se překládá na jednu hodnotu (například celé číslo), nebo seznam hodnot (například pole řetězců). Ačkoli každý člen v cestě může být seznam nebo vlastnost, konečný člen musí přeložit na vlastnost. Každý člen staví na předchozím členu: "Size.Height" se přeloží na Height vlastnost pro aktuální Size; "Regions.regionsToCustomers.CustomerFirstName" se přeloží na křestní jméno aktuálního zákazníka, kde je zákazník jedním ze zákazníků pro aktuální oblast.
Vrátí DataRelation seznam hodnot propojením jedné DataTable a druhé DataTable hodnoty v objektu DataSet. Pokud objekt DataSet obsahuje DataRelation objekty, můžete zadat datový člen jako následovaný TableNameRelationNamea potom ColumnName. Pokud například DataTable pojmenovaný "Dodavatelé" obsahuje pojmenovaný DataRelation "suppliers2products", datový člen může být "Suppliers.suppliers2products.ProductName".
Zdroj dat se může skládat ze sady souvisejících tříd. Představte si například sadu tříd, které katalogují sluneční soustavy. Třída s názvem System obsahuje vlastnost s názvem Stars , která vrací kolekci Star objektů. Každý Star objekt má Name vlastnosti a Mass a také Planets vlastnost, která vrací kolekci Planet objektů. V tomto systému má každá planeta Mass také vlastnosti a Name . Každý Planet objekt má Moons dále vlastnost, která vrací kolekci Moon objektů, z nichž každý má Name také vlastnosti a Mass . Pokud jako zdroj dat zadáte System objekt, můžete jako datový člen zadat kterýkoli z následujících položek:
"Stars.Name"
"Stars.Mass"
"Stars.Planets.Name"
"Stars.Planets.Mass"
"Stars.Planets.Moons.Name"
"Stars.Planets.Moons.Mass"
Ovládací prvky, které mohou být jednoduchou vazbou, obsahují kolekci Binding objektů v objektu ControlBindingsCollection, ke které můžete přistupovat prostřednictvím vlastnosti ovládacího prvku DataBindings . Do kolekce přidáte Binding voláním Add metody , čímž svážete vlastnost ovládacího prvku s vlastností objektu (nebo s vlastností aktuálního objektu v seznamu).
Jednoduchou vazbu můžete použít k libovolnému objektu System.Windows.Forms.Control , který je odvozený z třídy , například následující ovládací prvky systému Windows:
Poznámka
SelectedValue Pouze vlastnost ComboBoxovládacího prvku , CheckedListBoxa ListBox je jednoduchá vázaná.
Třída BindingManagerBase je abstraktní třída, která spravuje všechny Binding objekty pro konkrétní zdroj dat a datový člen. Třídy odvozené z BindingManagerBase jsou CurrencyManager třídy a PropertyManager . Binding Způsob, jakým se objekt spravuje, závisí na tom, Binding jestli se jedná o vazbu seznamu nebo o vazbu vlastnosti. Pokud se například jedná o vazbu seznamu, můžete k určení v seznamu Positionpoužít BindingManagerBasePosition . Proto určuje, která položka (ze všech položek v seznamu) je ve skutečnosti vázána k ovládacímu prvku. Pokud chcete vrátit odpovídající BindingManagerBasehodnotu , použijte BindingContext.
Chcete-li přidat nový řádek do sady ovládacích prvků vázaných na stejnou DataSource, použijte AddNew metodu BindingManagerBase třídy . Item[] Použijte vlastnost BindingContext třídy k vrácení příslušného CurrencyManagerobjektu . K uvozování z přidání nového řádku použijte metodu CancelCurrentEdit .
Konstruktory
| Binding(String, Object, String) |
Inicializuje novou instanci Binding třídy, která simple-váže vlastnost určeného ovládacího prvku na zadaný datový člen zdroje dat. |
| Binding(String, Object, String, Boolean) |
Inicializuje novou instanci Binding třídy, která sváže vlastnost určeného ovládacího prvku se zadaným datovým členem zdroje dat a volitelně povolí použití formátování. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode) |
Inicializuje novou instanci Binding třídy, která váže vlastnost zadaného ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně povolí formátování a rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Inicializuje novou instanci Binding třídy, která vytvoří vazbu vlastnosti určeného ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně povolí formátování, rozšíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace a nastaví vlastnost na zadanou DBNull hodnotu, když se vrátí ze zdroje dat. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Inicializuje novou instanci Binding třídy, která váže vlastnost zadaného ovládacího prvku na zadaný datový člen zadaného zdroje dat. Volitelně umožňuje formátování pomocí zadaného řetězce formátu; šíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; a nastaví vlastnost na zadanou hodnotu, když je vrácen ze DBNull zdroje dat. |
| Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Inicializuje novou instanci Binding třídy se zadanou ovládací vlastností zadaného datového člena zadaného zdroje dat. Volitelně umožňuje formátování pomocí zadaného řetězce formátu; šíří hodnoty do zdroje dat na základě zadaného nastavení aktualizace; umožňuje formátování se zadaným formátovacím řetězcem; Nastaví vlastnost na zadanou hodnotu při DBNull vrácení ze zdroje dat a nastaví zadaného zprostředkovatele formátu. |
Vlastnosti
| BindableComponent |
Získá ovládací prvek je Binding přidružen k. |
| BindingManagerBase |
Získá pro BindingManagerBase tento Bindingobjekt . |
| BindingMemberInfo |
Získá objekt, který obsahuje informace o této vazbě na základě parametru |
| Control |
Získá ovládací prvek, ke kterému vazba patří. |
| ControlUpdateMode |
Získá nebo nastaví, když se změny zdroje dat rozšíří do vlastnosti vázaného ovládacího prvku. |
| DataSource |
Získá zdroj dat pro tuto vazbu. |
| DataSourceNullValue |
Získá nebo nastaví hodnotu, která má být uložena ve zdroji dat, pokud je |
| DataSourceUpdateMode |
Získá nebo nastaví hodnotu, která označuje, kdy změny vlastnosti vázaného ovládacího prvku jsou rozšířeny do zdroje dat. |
| FormatInfo |
Získá nebo nastaví , IFormatProvider který poskytuje vlastní formátování chování. |
| FormatString |
Získá nebo nastaví znaky specifikátoru formátu, které označují způsob zobrazení hodnoty. |
| FormattingEnabled |
Získá nebo nastaví hodnotu označující, zda převod typu a formátování je použit na data vlastnosti ovládacího prvku. |
| IsBinding |
Získá hodnotu označující, zda je vazba aktivní. |
| NullValue |
Získá nebo nastaví Object jako vlastnost ovládacího prvku, pokud zdroj dat obsahuje DBNull hodnotu. |
| PropertyName |
Získá název vlastnosti vázané na data ovládacího prvku. |
Metody
| Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
| GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
| GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
| OnBindingComplete(BindingCompleteEventArgs) |
BindingComplete Vyvolá událost. |
| OnFormat(ConvertEventArgs) |
Format Vyvolá událost. |
| OnParse(ConvertEventArgs) |
Parse Vyvolá událost. |
| ReadValue() |
Nastaví vlastnost ovládacího prvku na hodnotu přečtenou ze zdroje dat. |
| ToString() |
Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object) |
| WriteValue() |
Načte aktuální hodnotu z vlastnosti ovládacího prvku a zapíše ji do zdroje dat. |
Událost
| BindingComplete |
Vyvolá se, FormattingEnabled když je vlastnost nastavena na |
| Format |
Vyvolá se, když je vlastnost ovládacího prvku vázaná na hodnotu dat. |
| Parse |
Vyvolá se při změně hodnoty ovládacího prvku vázaného na data. |
Platí pro
Viz také
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro