ControlBindingsCollection ControlBindingsCollection ControlBindingsCollection ControlBindingsCollection Class

Определение

Представляет коллекцию привязок данных для элемента управления.Represents the collection of data bindings for a control.

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")]
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.ControlBindingsConverter, System.Design, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
[System.ComponentModel.TypeConverter("System.Windows.Forms.Design.ControlBindingsConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public class ControlBindingsCollection : System.Windows.Forms.BindingsCollection
type ControlBindingsCollection = class
    inherit BindingsCollection
Public Class ControlBindingsCollection
Inherits BindingsCollection
Наследование
Атрибуты

Примеры

В следующем примере кода добавляется Binding объектов ControlBindingsCollection пять элементов управления: четыре TextBox элементов управления и DateTimePicker элемента управления.The following code example adds Binding objects to a ControlBindingsCollection of five controls: four TextBox controls and a DateTimePicker control. Доступ к коллекции ControlBindingsCollection осуществляется с помощью свойства DataBindings класса Control.The ControlBindingsCollection is accessed through the DataBindings property of the Control class.

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    

Комментарии

Простая привязка данных выполняется путем добавления Binding объектов ControlBindingsCollection.Simple data binding is accomplished by adding Binding objects to a ControlBindingsCollection. Любой объект, который наследует от Control класс может обращаться к ControlBindingsCollection через DataBindings свойство.Any object that inherits from the Control class can access the ControlBindingsCollection through the DataBindings property. Для списка Windows элементов управления, поддерживающих привязку данных, см. в разделе Binding класса.For a list of Windows controls that support data binding, see the Binding class.

ControlBindingsCollection Содержит стандартные методы коллекций, такие как Add, Clear, и Remove.The ControlBindingsCollection contains standard collection methods such as Add, Clear, and Remove.

Чтобы получить элемент управления, которые ControlBindingsCollection принадлежит, используйте Control свойство.To get the control that the ControlBindingsCollection belongs to, use the Control property.

Конструкторы

ControlBindingsCollection(IBindableComponent) ControlBindingsCollection(IBindableComponent) ControlBindingsCollection(IBindableComponent) ControlBindingsCollection(IBindableComponent)

Инициализирует новый экземпляр класса ControlBindingsCollection, используя заданный привязываемый элемент управления.Initializes a new instance of the ControlBindingsCollection class with the specified bindable control.

Свойства

BindableComponent BindableComponent BindableComponent BindableComponent

Возвращает компонент IBindableComponent, которому принадлежит данная коллекция привязок.Gets the IBindableComponent the binding collection belongs to.

Control Control Control Control

Возвращает элемент управления, которому принадлежит данная коллекция.Gets the control that the collection belongs to.

Count Count Count Count

Возвращает общее количество привязок в коллекции.Gets the total number of bindings in the collection.

(Inherited from BindingsCollection)
DefaultDataSourceUpdateMode DefaultDataSourceUpdateMode DefaultDataSourceUpdateMode DefaultDataSourceUpdateMode

Возвращает или задает свойство DataSourceUpdateMode по умолчанию для привязки Binding в коллекции.Gets or sets the default DataSourceUpdateMode for a Binding in the collection.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Возвращает значение, указывающее, является ли коллекция доступной только для чтения.Gets a value indicating whether the collection is read-only.

(Inherited from BaseCollection)
IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Возвращает значение, определяющее, синхронизирован ли доступ к интерфейсу ICollection.Gets a value indicating whether access to the ICollection is synchronized.

(Inherited from BaseCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Возвращает объект Binding по указанному индексу.Gets the Binding at the specified index.

(Inherited from BindingsCollection)
Item[String] Item[String] Item[String] Item[String]

Возвращает привязку Binding, заданную именем свойства элемента управления.Gets the Binding specified by the control's property name.

List List List List

Получает привязки в коллекции в виде объекта.Gets the bindings in the collection as an object.

(Inherited from BindingsCollection)
SyncRoot SyncRoot SyncRoot SyncRoot

Получает объект, с помощью которого можно синхронизировать доступ к коллекции BaseCollection.Gets an object that can be used to synchronize access to the BaseCollection.

(Inherited from BaseCollection)

Методы

Add(Binding) Add(Binding) Add(Binding) Add(Binding)

Добавляет указанный параметр Binding в коллекцию.Adds the specified Binding to the collection.

Add(String, Object, String) Add(String, Object, String) Add(String, Object, String) Add(String, Object, String)

Создает Binding, используя имя свойства, источник данных и элемент данных заданного элемента управления, и добавляет эту привязку в коллекцию.Creates a Binding using the specified control property name, data source, and data member, and adds it to the collection.

Add(String, Object, String, Boolean) Add(String, Object, String, Boolean) Add(String, Object, String, Boolean) Add(String, Object, String, Boolean)

Создает привязку с заданным именем свойства для элемента управления, источником данных, элементом данных и сведениями о том, включено ли форматирование, и добавляет привязку в коллекцию.Creates a binding with the specified control property name, data source, data member, and information about whether formatting is enabled, and adds the binding to the collection.

Add(String, Object, String, Boolean, DataSourceUpdateMode) Add(String, Object, String, Boolean, DataSourceUpdateMode) Add(String, Object, String, Boolean, DataSourceUpdateMode) Add(String, Object, String, Boolean, DataSourceUpdateMode)

Создает привязку, связывающую указанное свойство элемента управления с заданными элементом данных указанного источника данных, при необходимости включая форматирование, распространение значений в источник данных в зависимости от заданных параметров обновления и добавление привязки в коллекцию.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, and adding the binding to the collection.

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Создает привязку, связывающую указанное свойство элемента управления с заданными элементом данных указанного источника данных, при необходимости включая форматирование, распространение значений в источник данных в зависимости от заданных настроек обновления, установку для свойства заданного значения при возвращении DBNull из источника данных и добавление привязки в коллекцию.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Создает привязку, связывающую указанное свойство элемента управления с заданными элементом данных указанного источника данных, при необходимости включая форматирование с заданной строкой формата, распространение значений в источник данных в зависимости от заданных настроек обновления, установку для свойства заданного значения при возвращении DBNull из источника данных и добавление привязки в коллекцию.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, and adding the binding to the collection.

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Создает привязку, связывающую указанное свойство элемента управления с заданными элементом данных указанного источника данных, при необходимости включая форматирование с заданной строкой формата, распространение значений в источник данных в зависимости от заданных настроек обновления, установку для свойства заданного значения при возвращении DBNull из источника данных, установку заданного поставщика формата и добавление привязки в коллекцию.Creates a binding that binds the specified control property to the specified data member of the specified data source, optionally enabling formatting with the specified format string, propagating values to the data source based on the specified update setting, setting the property to the specified value when DBNull is returned from the data source, setting the specified format provider, and adding the binding to the collection.

AddCore(Binding) AddCore(Binding) AddCore(Binding) AddCore(Binding)

Добавляет привязку в коллекцию.Adds a binding to the collection.

Clear() Clear() Clear() Clear()

Очищает коллекцию от привязок.Clears the collection of any bindings.

ClearCore() ClearCore() ClearCore() ClearCore()

Удаляет привязки в коллекции.Clears the bindings in the collection.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Копирует все элементы текущего одномерного массива Array в заданный одномерный массив Array, начиная с указанного индекса в массиве назначения Array.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Inherited from BaseCollection)
CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Получает объект, позволяющий выполнять итерацию по элементам коллекции.Gets the object that enables iterating through the members of the collection.

(Inherited from BaseCollection)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Получает объект службы времени существования для управления политикой времени существования для этого экземпляра.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs) OnCollectionChanged(CollectionChangeEventArgs) OnCollectionChanged(CollectionChangeEventArgs) OnCollectionChanged(CollectionChangeEventArgs)

Вызывает событие CollectionChanged.Raises the CollectionChanged event.

(Inherited from BindingsCollection)
OnCollectionChanging(CollectionChangeEventArgs) OnCollectionChanging(CollectionChangeEventArgs) OnCollectionChanging(CollectionChangeEventArgs) OnCollectionChanging(CollectionChangeEventArgs)

Создает событие CollectionChanging.Raises the CollectionChanging event.

(Inherited from BindingsCollection)
Remove(Binding) Remove(Binding) Remove(Binding) Remove(Binding)

Удаляет из коллекции указанную привязку Binding.Deletes the specified Binding from the collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Удаляет привязку Binding с заданынм индексом.Deletes the Binding at the specified index.

RemoveCore(Binding) RemoveCore(Binding) RemoveCore(Binding) RemoveCore(Binding)

Удаляет указанную привязку из коллекции.Removes the specified binding from the collection.

ShouldSerializeMyAll() ShouldSerializeMyAll() ShouldSerializeMyAll() ShouldSerializeMyAll()

Получает значение, показывающее, нужно ли выполнять сериализацию коллекции.Gets a value that indicates whether the collection should be serialized.

(Inherited from BindingsCollection)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

События

CollectionChanged CollectionChanged CollectionChanged CollectionChanged

Происходит при изменении коллекции.Occurs when the collection has changed.

(Inherited from BindingsCollection)
CollectionChanging CollectionChanging CollectionChanging CollectionChanging

Происходит перед изменением коллекции.Occurs when the collection is about to change.

(Inherited from BindingsCollection)

Методы расширения

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Преобразует IEnumerable для IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к