BindingContext Třída

Definice

public ref class BindingContext : System::Collections::ICollection

public class BindingContext : System.Collections.ICollection

type BindingContext = class
    interface ICollection
    interface IEnumerable

Public Class BindingContext
Implements ICollection

Dědičnost

Object

BindingContext

Implementuje

ICollection IEnumerable

Příklady

Následující příklad kódu vytvoří čtyři Binding objekty pro vazbu pěti ovládacích prvků – DateTimePicker a čtyř TextBox ovládacích prvků – s několika zdroji dat. Potom BindingContext se použije k získání hodnoty BindingManagerBase pro každý zdroj dat.

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 a navigation path in the form: 
         "TableName.ColumnName". */
   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 navigation path:
         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"];

   /* Bind the fourth TextBox control's Text property to the
      third control's Text property. */
   text4->DataBindings->Add( "Text", text3, "Text" );
}

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 a navigation path in the form: 
      "TableName.ColumnName". */
   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 navigation path:
      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"];

   /* Bind the fourth TextBox control's Text property to the
   third control's Text property. */
   text4.DataBindings.Add("Text", text3, "Text");
}

Protected 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 string 
   '   "TableName.ColumnName".
   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,  New ConvertEventHandler(AddressOf CurrencyStringToDecimal)      
   AddHandler b.Format, New ConvertEventHandler(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")

   ' Bind the fourth TextBox control's Text property to the
   ' third control's Text property.
   text4.DataBindings.Add("Text", text3, "Text")

End Sub

Poznámky

Každý formulář windows má alespoň jeden BindingContext objekt, který spravuje BindingManagerBase objekty formuláře. Vzhledem k tomu, že BindingManagerBase je třída abstraktní, návratový typ Item[] vlastnosti je buď a CurrencyManager , nebo PropertyManager. Pokud je zdrojem dat objekt, který může vrátit pouze jednu vlastnost (místo seznamu objektů), Type je objekt .PropertyManager Pokud například jako zdroj dat zadáte , TextBox vrátí se hodnota .PropertyManager Na druhou stranu, pokud zdroj dat je objekt, který implementuje IList nebo IBindingList, CurrencyManager se vrátí .

Pro každý zdroj dat ve formuláři Windows Forms existuje jeden CurrencyManager nebo PropertyManager. Vzhledem k tomu, že k formuláři Windows Form může být přidruženo více zdrojů dat, BindingContext umožňuje vám nástroj načíst všechny konkrétní CurrencyManager přidružené ke zdroji dat.

Pokud používáte kontejnerový ovládací prvek, jako GroupBoxje , Panelnebo TabControl, k tomu, aby obsahoval ovládací prvky vázané na data, můžete vytvořit BindingContext pouze pro tento ovládací prvek kontejneru a jeho ovládací prvky. Každou část formuláře pak můžete spravovat pomocí vlastního BindingManagerBase. BindingContext Další informace o vytváření více BindingManagerBase objektů pro stejný zdroj dat najdete v konstruktoru.

Pokud přidáte TextBox ovládací prvek do formuláře a svážete ho se sloupcem tabulky v datové sadě, bude tento ovládací prvek komunikovat s BindingContext objektem daného formuláře. Naopak BindingContext, mluví s konkrétními CurrencyManager daty pro dané přidružení dat. Pokud byste dotazovali Position vlastnost objektu CurrencyManager, nahlásil by aktuální záznam pro vazbu tohoto TextBox ovládacího prvku. V následujícím příkladu TextBox kódu je ovládací prvek vázaný na FirstName sloupec Customers tabulky v dataSet1 datové sadě prostřednictvím BindingContext pro formulář, ve který je.

TextBox1.DataBindings.Add("Text", dataSet1, "Customers.FirstName")  

textBox1.DataBindings.Add("Text", dataSet1, "Customers.FirstName");  

textBox1->DataBindings->Add("Text", dataSet1, "Customers.FirstName");  

Do formuláře můžete přidat druhý TextBox ovládací prvek (TextBox2) a svázat ho se LastName sloupcem Customers tabulky ve stejné datové sadě. Objekt BindingContext ví o první vazbu (TextBox1 na Customers.FirstName), takže použije stejnou CurrencyManager, protože obě textová pole jsou svázaná se stejnou datovou sadou (DataSet1).

TextBox2.DataBindings.Add("Text", dataSet1, "Customers.LastName")  

textBox2.DataBindings.Add("Text", dataSet1, "Customers.LastName");  

textBox2->DataBindings->Add("Text", dataSet1, "Customers.LastName");  

Pokud vytvoříte vazbu TextBox2 na jinou datovou sadu, BindingContext objekt vytvoří a spravuje sekundu CurrencyManager.

Je důležité, abyste měli konzistentní nastavení DataSource vlastností a DisplayMember . V opačném případě BindingContext vytvoří více správců měn pro stejnou datovou sadu, což vede k chybám. Následující příklad kódu ukazuje několik způsobů, jak nastavit vlastnosti a jejich přidružené BindingContext objekty. Vlastnosti můžete nastavit pomocí některé z následujících metod, pokud jste konzistentní v celém kódu.

ComboBox1.DataSource = DataSet1  
ComboBox1.DisplayMember = "Customers.FirstName"  
Me.BindingContext(dataSet1, "Customers").Position = 1  

comboBox1.DataSource = DataSet1;  
comboBox1.DisplayMember = "Customers.FirstName";  
this.BindingContext[dataSet1, "Customers"].Position = 1;  

comboBox1->DataSource = dataSet1;  
comboBox1->DisplayMember = "Customers.FirstName";  
this->BindingContext->get_Item(dataSet1, "Customers")->Position = 1;  

ComboBox1.DataSource = DataSet1.Customers  
ComboBox1.DisplayMember = "FirstName"  
Me.BindingContext(dataSet1.Customers).Position = 1  

comboBox1.DataSource = DataSet1.Customers;  
comboBox1.DisplayMember = "FirstName";  
this.BindingContext[dataSet1.Customers].Position = 1;  

comboBox1->DataSource = dataSet1->Customers;  
comboBox1->DisplayMember = "FirstName";  
this->BindingContext->get_Item(dataSet1->Customers)->Position = 1;  

Konstruktory

Vlastnosti

Metody

Událost

Explicitní implementace rozhraní

Metody rozšíření

Platí pro

Viz také

• BindingManagerBase
• Binding
• BindingsCollection