ControlBindingsCollection Classe

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa a coleção de associações de dados para um controle.

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

Herança

Object

MarshalByRefObject

BaseCollection

BindingsCollection

ControlBindingsCollection

Atributos

TypeConverterAttribute

Exemplos

O exemplo de código a seguir adiciona Binding objetos a um ControlBindingsCollection de cinco controles: quatro TextBox controles e um DateTimePicker controle. O ControlBindingsCollection é acessado por meio da DataBindings propriedade da Control classe .

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

Comentários

A associação de dados simples é realizada adicionando Binding objetos a um ControlBindingsCollection. Qualquer objeto herdado da Control classe pode acessar o ControlBindingsCollection por meio da DataBindings propriedade . Para obter uma lista de controles do Windows que dão suporte à associação de dados, consulte a Binding classe .

O ControlBindingsCollection contém métodos de coleção padrão, como Add, Cleare Remove.

Para obter o controle ao qual o ControlBindingsCollection pertence, use a Control propriedade .

Construtores

ControlBindingsCollection(IBindableComponent)

Inicializa uma nova instância da classe ControlBindingsCollection com o controle vinculável especificado.

Propriedades

BindableComponent	Obtém o IBindableComponent ao qual a coleção de associação pertence.
Control	Obtém o controle ao qual a coleção pertence.
Count	Obtém o número total de associações na coleção. (Herdado de BindingsCollection)
DefaultDataSourceUpdateMode	Obtém ou define o padrão DataSourceUpdateMode para um Binding na coleção.
IsReadOnly	Obtém um valor que indica se a coleção é somente leitura. (Herdado de BaseCollection)
IsSynchronized	Obtém um valor que indica se o acesso à ICollection é sincronizado. (Herdado de BaseCollection)
Item[Int32]	Obtém o Binding no índice especificado. (Herdado de BindingsCollection)
Item[String]	Obtém o Binding especificado pelo nome da propriedade do controle.
List	Obtém as associações na coleção como um objeto. (Herdado de BindingsCollection)
SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao BaseCollection. (Herdado de BaseCollection)

Métodos

Add(Binding)	Adiciona o Binding especificado à coleção.
Add(String, Object, String)	Cria um Binding usando o nome de propriedade do controle especificado, a fonte de dados e o membro de dados e o adiciona à coleção.
Add(String, Object, String, Boolean)	Cria uma associação ao nome da propriedade de controle, à fonte de dados, ao membro de dados especificados e informações sobre se a formatação está habilitada e adiciona a associação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Cria uma associação que associa a propriedade de controle especificada ao membro de dados especificado da fonte de dados especificada, opcionalmente habilitando a formatação, propagando os valores para a fonte de dados com base na configuração de atualização especificada e adicionando a associação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Cria uma associação que associa a propriedade de controle especificada ao membro de dados especificado da fonte de dados especificada, opcionalmente, habilitando a formatação, propagando os valores para a fonte de dados com base na configuração de atualização especificada, configurando a propriedade com o valor especificado quando DBNull é retornado da fonte de dados e adicionando a associação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Cria uma associação que associa a propriedade de controle especificada ao membro de dados especificado da fonte de dados especificada, opcionalmente, habilitando a formatação com a cadeia de formato especificada, propagando os valores para a fonte de dados com base na configuração de atualização especificada, definindo a propriedade com o valor especificado quando DBNull é retornado da fonte de dados e adicionando a associação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Cria uma associação que associa a propriedade de controle especificada ao membro de dados especificado da fonte de dados especificada, opcionalmente, habilitando a formatação com a cadeia de formato especificada, propagando os valores para a fonte de dados com base na configuração de atualização especificada, definindo a propriedade com o valor especificado quando DBNull é retornado da fonte de dados, definindo o provedor de formato especificado e adicionando a associação à coleção.
AddCore(Binding)	Adiciona uma associação à coleção.
Clear()	Limpa a coleção de todas as associações.
ClearCore()	Limpa as associações na coleção.
CopyTo(Array, Int32)	Copia todos os elementos do Array unidimensional atual para o Array unidimensional especificado, começando no índice Array de destino especificado. (Herdado de BaseCollection)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Obtém o objeto que permite a iteração através dos membros da coleção. (Herdado de BaseCollection)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)	Aciona o evento CollectionChanged. (Herdado de BindingsCollection)
OnCollectionChanging(CollectionChangeEventArgs)	Aciona o evento CollectionChanging. (Herdado de BindingsCollection)
Remove(Binding)	Exclui o Binding especificado da coleção.
RemoveAt(Int32)	Exclui o Binding no índice especificado.
RemoveCore(Binding)	Remove a associação especificada da coleção.
ShouldSerializeMyAll()	Obtém um valor que indica se a coleção deve ser serializada. (Herdado de BindingsCollection)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Eventos

CollectionChanged	Ocorre quando a coleção foi alterada. (Herdado de BindingsCollection)
CollectionChanging	Ocorre quando a coleção está prestes a ser alterada. (Herdado de BindingsCollection)

Métodos de Extensão