Binding Sınıf

  • Başvuru

Tanım

Ad Alanı:
System.Windows.Forms
Bütünleştirilmiş Kod:
System.Windows.Forms.dll

Bir nesnenin özellik değeri ile denetimin özellik değeri arasındaki basit bağlamayı temsil eder.

public ref class Binding
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListBindingConverter))]
public class Binding
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ListBindingConverter))>]
type Binding = class
Public Class Binding
Devralma
Object
Binding
Öznitelikler
TypeConverterAttribute

Örnekler

Aşağıdaki kod örneği, basit veri bağlamayı gösteren çeşitli denetimlere sahip bir Windows Formu oluşturur. Örnek, ve adlı iki tablo ve Ordersadlı CustomerscustToOrdersbir ile bir DataRelation oluştururDataSet. Dört denetim (a DateTimePicker ve üç TextBox denetim) tablolardaki sütunlara bağlı verilerdir. Her denetim için örnek, özelliği aracılığıyla bir Binding oluşturur ve denetime DataBindings ekler. Örnek, formun BindingContextaracılığıyla her tablo için bir BindingManagerBase döndürür. Dört Button denetim, nesnelerdeki PositionBindingManagerBase özelliği artırır veya geriler.

#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

Açıklamalar

Bir denetimin Binding özelliği ile bir nesnenin özelliği veya nesne listesindeki geçerli nesnenin özelliği arasında basit bir bağlama oluşturmak ve korumak için sınıfını kullanın.

İlk duruma örnek olarak, bir denetimin Text özelliğini nesnenin TextBox özelliğine FirstNameCustomer bağlayabilirsiniz. İkinci duruma örnek olarak, bir TextBox denetimin Text özelliğini müşterileri içeren bir DataTable özelliğine FirstName bağlayabilirsiniz.

sınıfı ayrıca Binding olay aracılığıyla görüntülenecek değerleri biçimlendirmenize ve olay aracılığıyla Format biçimlendirilmiş değerleri almanıza Parse olanak tanır.

Oluşturucu ile Binding bir Binding örnek oluştururken üç öğe belirtmeniz gerekir:

  • Bağlanacak denetim özelliğinin adı.

  • Veri kaynağı.

  • Veri kaynağındaki bir listeye veya özelliğe çözümlenebilen gezinti yolu. Gezinti yolu, nesnenin BindingMemberInfo özelliğini oluşturmak için de kullanılır.

İlk olarak, verileri bağlamak istediğiniz denetim özelliğinin adını belirtmeniz gerekir. Örneğin, bir TextBox denetimdeki verileri görüntülemek için özelliğini belirtin Text .

İkincisi, veri kaynağı olarak aşağıdaki tablodaki sınıflardan herhangi birinin örneğini belirtebilirsiniz.

Description C# örneği
veya ITypedListuygulayan tüm sınıflarIBindingList. Bunlar şunları içerir: DataSet, DataTable, DataViewveya DataViewManager. DataSet ds = new DataSet("myDataSet");
Dizine alınan bir nesne koleksiyonu oluşturmak için uygulayan IList herhangi bir sınıf. koleksiyonu oluşturulmadan önce Bindingoluşturulup doldurulmalıdır. Listedeki nesnelerin tümü aynı türde olmalıdır; aksi takdirde, bir özel durum oluşturulur. ArrayList ar1 = new ArrayList; Customer1 cust1 = new Customer("Louis"); ar1.Add(cust1);
Kesin olarak türü kesin belirlenmiş IList nesneler Customer [] custList = new Customer[3];

Üçüncü olarak, boş dize (""), tek bir özellik adı veya noktayla ayrılmış ad hiyerarşisi olabilecek gezinti yolunu belirtmeniz gerekir. Gezinti yolunu boş bir dize olarak ayarlarsanız, ToString yöntemi temel alınan veri kaynağı nesnesinde çağrılır.

Veri kaynağı birden çok DataColumn nesne içerebilen bir DataTableise, gezinti yolu belirli bir sütuna çözümlemek için kullanılmalıdır.

Not

Veri kaynağı bir DataSet, DataViewManagerveya DataTableolduğunda, aslında bir DataViewöğesine bağlanmış olursunuz. Sonuç olarak, bağlı satırlar aslında DataRowView nesnelerdir.

Veri kaynağı birden çok DataTable nesne (veya DataViewManagergibi) içeren bir nesneye ayarlandığında noktayla ayrılmış gezinti DataSet yolu gerekir. Ayrıca, özellikleri diğer nesnelere başvuru döndüren bir nesneye (diğer sınıf nesnelerini döndüren özelliklere sahip bir sınıf gibi) bağladığınızda noktalı olarak sınırlandırılmış gezinti yolu da kullanabilirsiniz. Örneğin, aşağıdaki gezinti yollarının tümü geçerli veri alanlarını açıklar:

  • "Size.Height"

  • "Suppliers.CompanyName"

  • "Regions.regionsToCustomers.CustomerFirstName"

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

Yolun her üyesi, tek bir değere (tamsayı gibi) çözümleyen bir özellik veya değer listesi (dize dizisi gibi) döndürebilir. Yoldaki her üye bir liste veya özellik olsa da, son üyenin bir özelliğe çözümlenmesi gerekir. Her üye önceki üyeyi oluşturur: "Size.Height", geçerli Sizeöğesinin Height özelliğine çözümler; "Regions.regionsToCustomers.CustomerFirstName", geçerli müşterinin adı olarak çözümleniyor ve burada müşteri geçerli bölgenin müşterilerinden biri.

, DataRelation içindeki bir değeri saniyeye DataTable bağlayarak DataTable bir DataSetdeğer listesi döndürür. DataSet nesneleri içeriyorsaDataRelation, veri üyesini bir olarak ve ardından ColumnNamebir RelationNameolarak TableName belirtebilirsiniz. Örneğin, DataTable "Suppliers" adlı "Suppliers2products" adlı bir DataRelation ad içeriyorsa, veri üyesi "Suppliers.suppliers2products.ProductName" olabilir.

Veri kaynağı bir dizi ilgili sınıftan oluşabilir. Örneğin, güneş sistemlerini kataloglayan bir sınıf kümesi düşünün. adlı System sınıf, bir nesne koleksiyonu Star döndüren adlı Stars bir özellik içerir. Her Star nesnenin ve Mass özelliklerinin yanı sıra bir Planets nesne koleksiyonu Planet döndüren bir özelliği vardırName. Bu sistemde her gezegenin ve Name özellikleri de vardırMass. Her Planet nesnenin ayrıca ve Mass özelliklerine de sahip olan bir nesne koleksiyonu Moon döndüren bir Moons özelliği vardırName. Veri kaynağı olarak bir System nesne belirtirseniz, aşağıdakilerden herhangi birini veri üyesi olarak belirtebilirsiniz:

  • "Stars.Name"

  • "Yıldızlar.Kütle"

  • "Stars.Planets.Name"

  • "Yıldızlar.Gezegenler.Kütle"

  • "Stars.Planets.Moons.Name"

  • "Stars.Planets.Moons.Mass"

Basit bağlantılı olabilecek denetimler, denetimin Binding özelliği aracılığıyla DataBindings erişebileceğiniz bir ControlBindingsCollectioniçindeki nesne koleksiyonunu içerir. yöntemini çağırarak Add koleksiyonuna bir Binding eklersiniz, böylece denetimin bir özelliğini bir nesnenin özelliğine (veya listedeki geçerli nesnenin bir özelliğine) bağlarsınız.

Sınıfından türetilen System.Windows.Forms.Control herhangi bir nesneye basit bağlama yapabilirsiniz, örneğin, aşağıdaki Windows denetimleri:

Not

SelectedValue Yalnızca , CheckedListBoxve ListBox denetiminin ComboBoxözelliği basit bir sınırdır.

BindingManagerBase sınıfı, belirli bir veri kaynağı ve veri üyesi için tüm Binding nesneleri yöneten soyut bir sınıftır. 'den BindingManagerBase türetilen sınıflar ve PropertyManager sınıflarıdırCurrencyManager. a'nın Binding nasıl yönetileceğinin bir liste bağlaması mı yoksa özellik bağlaması mı olduğuna Binding bağlıdır. Örneğin, bir liste bağlamasıysa, öğesini kullanarak listede bir Position belirtebilirsinizBindingManagerBase; Positionbu nedenle, hangi öğenin (listedeki tüm öğelerden) aslında bir denetime bağlı olduğunu belirler. Uygun BindingManagerBasedeğerini döndürmek için kullanın BindingContext.

Aynı DataSourceöğesine bağlı denetim kümesine yeni bir satır eklemek için sınıfının yöntemini BindingManagerBase kullanınAddNew. Item[] Uygun CurrencyManagerdeğerini döndürmek için sınıfının özelliğini BindingContext kullanın. Yeni satırın eklenmesinden kurtulmak için yöntemini kullanın CancelCurrentEdit .

Oluşturucular

Binding(String, Object, String)

Sınıfının, belirtilen denetim özelliğini veri kaynağının belirtilen veri üyesine basit olarak bağlayan yeni bir örneğini Binding başlatır.
Binding(String, Object, String, Boolean)

Belirtilen denetim özelliğini veri kaynağının Binding belirtilen veri üyesine bağlayan ve isteğe bağlı olarak biçimlendirmenin uygulanmasını sağlayan sınıfının yeni bir örneğini başlatır.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)

Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak biçimlendirmeyi etkinleştirir ve belirtilen güncelleştirme ayarına göre değerleri veri kaynağına yayılım.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak biçimlendirmeyi etkinleştirir, belirtilen güncelleştirme ayarını temel alarak değerleri veri kaynağına yayılım ve veri kaynağından bir DBNull döndürildiğinde özelliği belirtilen değere ayarlar.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; belirtilen güncelleştirme ayarına göre değerleri veri kaynağına yayılım; ve veri kaynağından bir DBNull döndürülürken özelliğini belirtilen değere ayarlar.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Belirtilen veri kaynağının belirtilen veri üyesine Binding belirtilen denetim özelliğiyle sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; belirtilen güncelleştirme ayarına göre değerleri veri kaynağına yayılım; belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; , veri kaynağından bir döndürülürken DBNull özelliğini belirtilen değere ayarlar ve belirtilen biçim sağlayıcısını ayarlar.

Özellikler

BindableComponent

İlişkili olduğu denetimi Binding alır.
BindingManagerBase

Bunun Bindingiçin öğesini BindingManagerBase alır.
BindingMemberInfo

Oluşturucudaki Binding parametresine göre dataMember bu bağlama hakkında bilgi içeren bir nesnesi alır.
Control

Bağlamanın ait olduğu denetimi alır.
ControlUpdateMode

Veri kaynağındaki değişiklikler ilişkili denetim özelliğine yayıldığında alır veya ayarlar.
DataSource

Bu bağlama için veri kaynağını alır.
DataSourceNullValue

Denetim değeri boş veya boşsa veri kaynağında depolanacak değeri null alır veya ayarlar.
DataSourceUpdateMode

İlişkili denetim özelliğindeki değişikliklerin veri kaynağına ne zaman yayıldığını belirten bir değer alır veya ayarlar.
FormatInfo

Özel biçimlendirme davranışı sağlayan öğesini IFormatProvider alır veya ayarlar.
FormatString

Bir değerin nasıl görüntüleneceğini gösteren biçim belirtici karakterlerini alır veya ayarlar.
FormattingEnabled

Denetim özelliği verilerine tür dönüştürme ve biçimlendirme uygulanıp uygulanmadığını belirten bir değer alır veya ayarlar.
IsBinding

Bağlamanın etkin olup olmadığını belirten bir değer alır.
NullValue

Veri kaynağı bir DBNull değer içerdiğinde denetim özelliği olarak ayarlanacak değerini alır veya ayarlarObject.
PropertyName

Denetimin veriye bağlı özelliğinin adını alır.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
OnBindingComplete(BindingCompleteEventArgs)

Olayı tetikler BindingComplete .
OnFormat(ConvertEventArgs)

Olayı tetikler Format .
OnParse(ConvertEventArgs)

Olayı tetikler Parse .
ReadValue()

Denetim özelliğini veri kaynağından okunan değere ayarlar.
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)
WriteValue()

Geçerli değeri denetim özelliğinden okur ve veri kaynağına yazar.

Ekinlikler

BindingComplete

FormattingEnabled Özelliği olarak ayarlandığında true ve bir bağlama işlemi tamamlandığında (örneğin, veriler denetimden veri kaynağına gönderildiğinde veya tam tersi) gerçekleşir.
Format

Bir denetimin özelliği bir veri değerine bağlı olduğunda gerçekleşir.
Parse

Veriye bağlı denetimin değeri değiştiğinde gerçekleşir.

Şunlara uygulanır

Ayrıca bkz.