ControlBindingsCollection Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Denetim için veri bağlamaları koleksiyonunu temsil eder.

public ref class ControlBindingsCollection : System::Windows::Forms::BindingsCollection

[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.ControlBindingsConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public class ControlBindingsCollection : System.Windows.Forms.BindingsCollection

[<System.ComponentModel.TypeConverter("System.Windows.Forms.Design.ControlBindingsConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
type ControlBindingsCollection = class
    inherit BindingsCollection

Public Class ControlBindingsCollection
Inherits BindingsCollection

Devralma

Object

MarshalByRefObject

BaseCollection

BindingsCollection

ControlBindingsCollection

Öznitelikler

TypeConverterAttribute

Örnekler

Aşağıdaki kod örneği, nesneleri beş denetimden oluşan bir denetime eklerBinding: dört TextBox denetim ve bir DateTimePicker denetim.ControlBindingsCollection öğesine ControlBindingsCollection sınıfının özelliği Control aracılığıyla DataBindings erişilir.

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 navigation path: 
         TableName.ColumnName. */
      textBox1->DataBindings->Add( gcnew Binding(
         "Text",ds,"customers.custName" ) );
      textBox2->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. */
      DateTimePicker1->DataBindings->Add( gcnew Binding(
         "Value",ds,"customers.CustToOrders.OrderDate" ) );
      
      /* Create a new Binding using the DataSet and a 
         navigation path(TableName.RelationName.ColumnName).
         Add event delegates for the Parse and Format events to 
         the 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 );
      textBox3->DataBindings->Add( b );
      
      /*Bind the fourth TextBox to the Value of the 
         DateTimePicker control. This demonstates how one control
         can be data-bound to another.*/
      textBox4->DataBindings->Add( "Text", DateTimePicker1, "Value" );
      
      // Get the BindingManagerBase for the textBox4 Binding.
      BindingManagerBase^ bmText = this->BindingContext[
         DateTimePicker1 ];
      
      /* Print the Type of the BindingManagerBase, which is 
         a PropertyManager because the data source
         returns only a single property value. */
      Console::WriteLine( bmText->GetType() );
      
      // Print the count of managed objects, which is one.
      Console::WriteLine( bmText->Count );
      
      // Get the BindingManagerBase for the Customers table. 
      bmCustomers = this->BindingContext[ds, "Customers"];
      
      /* Print the Type and count of the BindingManagerBase.
         Because the data source inherits from IBindingList,
         it is a RelatedCurrencyManager (a derived class of
         CurrencyManager). */
      Console::WriteLine( bmCustomers->GetType() );
      Console::WriteLine( bmCustomers->Count );
      
      /* Get the BindingManagerBase for the Orders of the current
         customer using a navigation path: TableName.RelationName. */
      bmOrders = this->BindingContext[ds, "customers.CustToOrders"];
   }

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 navigation path: 
   TableName.ColumnName. */
   textBox1.DataBindings.Add(new Binding
   ("Text", ds, "customers.custName"));
   textBox2.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. */
   DateTimePicker1.DataBindings.Add(new 
   Binding("Value", ds, "customers.CustToOrders.OrderDate"));

   /* Create a new Binding using the DataSet and a 
   navigation path(TableName.RelationName.ColumnName).
   Add event delegates for the Parse and Format events to 
   the 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);
   textBox3.DataBindings.Add(b);

   /*Bind the fourth TextBox to the Value of the 
   DateTimePicker control. This demonstates how one control
   can be data-bound to another.*/
   textBox4.DataBindings.Add("Text", DateTimePicker1,"Value");

   // Get the BindingManagerBase for the textBox4 Binding.
   BindingManagerBase bmText = this.BindingContext
   [DateTimePicker1];

   /* Print the Type of the BindingManagerBase, which is 
   a PropertyManager because the data source
   returns only a single property value. */
   Console.WriteLine(bmText.GetType().ToString());

   // Print the count of managed objects, which is one.
   Console.WriteLine(bmText.Count);

   // Get the BindingManagerBase for the Customers table. 
   bmCustomers = this.BindingContext [ds, "Customers"];

   /* Print the Type and count of the BindingManagerBase.
   Because the data source inherits from IBindingList,
   it is a RelatedCurrencyManager (a derived class of
   CurrencyManager). */
   Console.WriteLine(bmCustomers.GetType().ToString());
   Console.WriteLine(bmCustomers.Count);
   
   /* Get the BindingManagerBase for the Orders of the current
   customer using a navigation path: TableName.RelationName. */ 
   bmOrders = this.BindingContext[ds, "customers.CustToOrders"];
}

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 navigation path: 
    ' TableName.ColumnName. 
    textBox1.DataBindings.Add _
       (New Binding("Text", ds, "customers.custName"))
    textBox2.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. 
    DateTimePicker1.DataBindings.Add _
       (New Binding("Value", ds, "customers.CustToOrders.OrderDate"))
    
    ' Create a new Binding using the DataSet and a 
    ' navigation path(TableName.RelationName.ColumnName).
    ' Add event delegates for the Parse and Format events to 
    ' the 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 New Binding("Text", ds, "customers.custToOrders.OrderAmount")
    AddHandler b.Parse, AddressOf CurrencyStringToDecimal
    AddHandler b.Format, AddressOf DecimalToCurrencyString
    textBox3.DataBindings.Add(b)
    
    ' Bind the fourth TextBox to the Value of the 
    ' DateTimePicker control. This demonstates how one control
    ' can be data-bound to another.
    textBox4.DataBindings.Add("Text", DateTimePicker1, "Value")
    
    ' Get the BindingManagerBase for the textBox4 Binding.
    Dim bmText As BindingManagerBase = Me.BindingContext(DateTimePicker1)
    
    ' Print the Type of the BindingManagerBase, which is 
    ' a PropertyManager because the data source
    ' returns only a single property value. 
    Console.WriteLine(bmText.GetType().ToString())
    
    ' Print the count of managed objects, which is one.
    Console.WriteLine(bmText.Count)
    
    ' Get the BindingManagerBase for the Customers table. 
    bmCustomers = Me.BindingContext(ds, "Customers")
    
    ' Print the Type and count of the BindingManagerBase.
    ' Because the data source inherits from IBindingList,
    ' it is a RelatedCurrencyManager (a derived class of
    ' CurrencyManager). 
    Console.WriteLine(bmCustomers.GetType().ToString())
    Console.WriteLine(bmCustomers.Count)
    
    ' Get the BindingManagerBase for the Orders of the current
    ' customer using a navigation path: TableName.RelationName. 
    bmOrders = Me.BindingContext(ds, "customers.CustToOrders")
End Sub

Açıklamalar

Basit veri bağlama, öğesine ControlBindingsCollectionnesneler eklenerek Binding gerçekleştirilir. sınıfından devralan Control herhangi bir nesne özelliği aracılığıyla DataBindings öğesine ControlBindingsCollection erişebilir. Veri bağlamayı destekleyen Windows denetimlerinin listesi için sınıfına Binding bakın.

, ControlBindingsCollectionClearve Removegibi Addstandart koleksiyon yöntemlerini içerir.

öğesinin ait olduğu ControlBindingsCollection denetimi almak için özelliğini kullanın Control .

Oluşturucular

ControlBindingsCollection(IBindableComponent)

Belirtilen bağlanabilir denetimle sınıfının yeni bir örneğini ControlBindingsCollection başlatır.

Özellikler

BindableComponent	Bağlama koleksiyonunun IBindableComponent ait olduğu alır.
Control	Koleksiyonun ait olduğu denetimi alır.
Count	Koleksiyondaki bağlamaların toplam sayısını alır. (Devralındığı yer: BindingsCollection)
DefaultDataSourceUpdateMode	Koleksiyondaki için Binding varsayılanı DataSourceUpdateMode alır veya ayarlar.
IsReadOnly	Topluluğun salt okunur olup olmadığını gösteren bir değer alır. (Devralındığı yer: BaseCollection)
IsSynchronized	öğesine erişimin ICollection eşitlenip eşitlenmediğini belirten bir değer alır. (Devralındığı yer: BaseCollection)
Item[Int32]	Belirtilen dizinde değerini Binding alır. (Devralındığı yer: BindingsCollection)
Item[String]	Denetimin Binding özellik adı tarafından belirtilen değerini alır.
List	Koleksiyondaki bağlamaları bir nesne olarak alır. (Devralındığı yer: BindingsCollection)
SyncRoot	erişimi BaseCollectioneşitlemek için kullanılabilecek bir nesnesi alır. (Devralındığı yer: BaseCollection)

Yöntemler

Add(Binding)	Belirtilen Binding öğesini koleksiyona ekler.
Add(String, Object, String)	Belirtilen denetim özelliği adını, veri kaynağını ve veri üyesini kullanarak bir Binding oluşturur ve bunu koleksiyona ekler.
Add(String, Object, String, Boolean)	Belirtilen denetim özelliği adına, veri kaynağına, veri üyesine ve biçimlendirmenin etkinleştirilip etkinleştirilmediğine ilişkin bilgilere sahip bir bağlama oluşturur ve bağlamayı koleksiyona ekler.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürildiğinde DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan bir bağlama oluşturur; isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlar ve bağlamayı koleksiyona ekler.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan bir bağlama oluşturur; isteğ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 yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlar, belirtilen biçim sağlayıcısını ayarlar, ve bağlamayı koleksiyona ekler.
AddCore(Binding)	Koleksiyona bir bağlama ekler.
Clear()	Tüm bağlamaların koleksiyonunu temizler.
ClearCore()	Koleksiyondaki bağlamaları temizler.
CopyTo(Array, Int32)	Geçerli tek boyutlu Array öğenin tüm öğelerini belirtilen hedef Array dizinden başlayarak belirtilen tek boyutluya Array kopyalar. (Devralındığı yer: BaseCollection)
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetEnumerator()	Koleksiyonun üyeleri arasında yinelemeyi sağlayan nesnesini alır. (Devralındığı yer: BaseCollection)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Olayı tetikler CollectionChanged . (Devralındığı yer: BindingsCollection)
OnCollectionChanging(CollectionChangeEventArgs)	Olayı tetikler CollectionChanging . (Devralındığı yer: BindingsCollection)
Remove(Binding)	Belirtilen Binding öğesini koleksiyondan siler.
RemoveAt(Int32)	Belirtilen dizinde öğesini Binding siler.
RemoveCore(Binding)	Belirtilen bağlamayı koleksiyondan kaldırır.
ShouldSerializeMyAll()	Koleksiyonun seri hale getirilip getirilmeyeceğini belirten bir değer alır. (Devralındığı yer: BindingsCollection)
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ekinlikler

CollectionChanged	Koleksiyon değiştiğinde gerçekleşir. (Devralındığı yer: BindingsCollection)
CollectionChanging	Koleksiyon değişmek üzere olduğunda gerçekleşir. (Devralındığı yer: BindingsCollection)

Uzantı Metotları