Partilhar via


ControlBindingsCollection.Add Método

Definição

Adiciona um Binding à coleção.

Sobrecargas

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.

Add(Binding)

Adiciona o Binding especificado à coleção.

public:
 void Add(System::Windows::Forms::Binding ^ binding);
public void Add (System.Windows.Forms.Binding binding);
override this.Add : System.Windows.Forms.Binding -> unit
Public Sub Add (binding As Binding)

Parâmetros

binding
Binding

O Binding a ser adicionado.

Exceções

O binding é nulo.

A propriedade de controle já está associada a dados.

- ou -

O Binding não especifica uma coluna válida do DataSource.

Exemplos

O exemplo de código a seguir cria uma Binding instância e usa o Add método para adicionar a instância ao ControlBindingsCollection de um TextBox controle .

protected:
   void BindControls()
   {
      /* 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 );
      textBox1->DataBindings->Add( b );
   }
protected void BindControls()
{
   /* 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);
   textBox1.DataBindings.Add(b);
}
Protected Sub BindControls()
    ' 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
    textBox1.DataBindings.Add(b)
End Sub

Comentários

A DataSourceUpdateMode propriedade do Binding criado por essa sobrecarga do Add método é definida como o valor da DefaultDataSourceUpdateMode propriedade .

O CollectionChanged evento ocorre quando a alteração é concluída.

Aplica-se a

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.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember);
override this.Add : string * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String) As Binding

Parâmetros

propertyName
String

O nome da propriedade do controle a ser associada.

dataSource
Object

Um Object que representa a fonte de dados.

dataMember
String

A propriedade ou lista à qual associar.

Retornos

O Binding recém-criado.

Exceções

O binding é null.

O propertyName já está associado a dados.

- ou -

O dataMember não especifica um membro válido do dataSource.

Exemplos

O exemplo de código a seguir usa o Add método para adicionar três Binding objetos ao ControlBindingsCollection de um TextBox controle . O ControlBindingsCollection é acessado por meio da DataBindings propriedade da Control classe .

private:
   void BindTextBoxProperties()
   {
      // Clear the collection before adding new Binding objects.
      textBox1->DataBindings->Clear();

      // Create a DataTable containing Color objects.
      DataTable^ t = MakeTable();

      /* Bind the Text, BackColor, and ForeColor properties
         to columns in the DataTable. */
      textBox1->DataBindings->Add( "Text", t, "Text" );
      textBox1->DataBindings->Add( "BackColor", t, "BackColor" );
      textBox1->DataBindings->Add( "ForeColor", t, "ForeColor" );
   }

   DataTable^ MakeTable()
   {
      /* Create a DataTable with three columns.
         Two of the columns contain Color objects. */
      DataTable^ t = gcnew DataTable( "Control" );
      t->Columns->Add( "BackColor", Color::typeid );
      t->Columns->Add( "ForeColor", Color::typeid );
      t->Columns->Add( "Text" );

      // Add three rows to the table.
      DataRow^ r;
      r = t->NewRow();
      r[ "BackColor" ] = Color::Blue;
      r[ "ForeColor" ] = Color::Yellow;
      r[ "Text" ] = "Yellow on Blue";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::White;
      r[ "ForeColor" ] = Color::Green;
      r[ "Text" ] = "Green on white";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::Orange;
      r[ "ForeColor" ] = Color::Black;
      r[ "Text" ] = "Black on Orange";
      t->Rows->Add( r );
      return t;
   }
private void BindTextBoxProperties()
{
   // Clear the collection before adding new Binding objects.
   textBox1.DataBindings.Clear();

   // Create a DataTable containing Color objects.
   DataTable t = MakeTable();

   /* Bind the Text, BackColor, and ForeColor properties
   to columns in the DataTable. */
   textBox1.DataBindings.Add("Text", t, "Text");
   textBox1.DataBindings.Add("BackColor", t, "BackColor");
   textBox1.DataBindings.Add("ForeColor", t, "ForeColor");
}

private DataTable MakeTable()
{
   /* Create a DataTable with three columns.
   Two of the columns contain Color objects. */

   DataTable t = new DataTable("Control");
   t.Columns.Add("BackColor", typeof(Color));
   t.Columns.Add("ForeColor", typeof(Color));
   t.Columns.Add("Text");

   // Add three rows to the table.
   DataRow r;

   r = t.NewRow();
   r["BackColor"] = Color.Blue;
   r["ForeColor"] = Color.Yellow;
   r["Text"] = "Yellow on Blue";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.White;
   r["ForeColor"] = Color.Green;
   r["Text"] = "Green on white";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.Orange;
   r["ForeColor"] = Color.Black;
   r["Text"] = "Black on Orange";
   t.Rows.Add(r);

   return t;
}
Private Sub BindTextBoxProperties()
    ' Clear the collection before adding new Binding objects.
    textBox1.DataBindings.Clear()
    
    ' Create a DataTable containing Color objects.
    Dim t As DataTable = MakeTable()
    
    ' Bind the Text, BackColor, and ForeColor properties
    ' to columns in the DataTable. 
    textBox1.DataBindings.Add("Text", t, "Text")
    textBox1.DataBindings.Add("BackColor", t, "BackColor")
    textBox1.DataBindings.Add("ForeColor", t, "ForeColor")
End Sub    

Private Function MakeTable() As DataTable
    ' Create a DataTable with three columns.
    ' Two of the columns contain Color objects. 
    
    Dim t As New DataTable("Control")
    t.Columns.Add("BackColor", GetType(Color))
    t.Columns.Add("ForeColor", GetType(Color))
    t.Columns.Add("Text")
    
    ' Add three rows to the table.
    Dim r As DataRow
    
    r = t.NewRow()
    r("BackColor") = Color.Blue
    r("ForeColor") = Color.Yellow
    r("Text") = "Yellow on Blue"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.White
    r("ForeColor") = Color.Green
    r("Text") = "Green on white"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.Orange
    r("ForeColor") = Color.Black
    r("Text") = "Black on Orange"
    t.Rows.Add(r)
    
    Return t
End Function

Comentários

A DataSourceUpdateMode propriedade do Binding criado por essa sobrecarga do Add método é definida como o valor da DefaultDataSourceUpdateMode propriedade .

Adicionar um Binding faz com que o CollectionChanged evento ocorra.

Aplica-se a

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.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled);
override this.Add : string * obj * string * bool -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean) As Binding

Parâmetros

propertyName
String

O nome da propriedade do controle a ser associada.

dataSource
Object

Um Object que representa a fonte de dados.

dataMember
String

A propriedade ou lista à qual associar.

formattingEnabled
Boolean

true para formatar os dados exibidos; caso contrário, false.

Retornos

O Binding recém-criado.

Exceções

A propriedade fornecida por propertyName não existe no controle.

- ou -

A propriedade especificada é uma propriedade somente leitura.

Se a formatação estiver desabilitada e propertyName não for uma propriedade válida de um controle nem uma cadeia de caracteres vazia ("").

Aplica-se a

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.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode) As Binding

Parâmetros

propertyName
String

O nome da propriedade do controle a ser associada.

dataSource
Object

Um Object que representa a fonte de dados.

dataMember
String

A propriedade ou lista à qual associar.

formattingEnabled
Boolean

true para formatar os dados exibidos; caso contrário, false.

updateMode
DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

Retornos

O Binding recém-criado.

Exceções

A propriedade especificada por propertyName não existe no controle ou é somente leitura.

- ou -

O membro de dados especificado não existe na fonte de dados.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificada está associada a outra associação na coleção.

Comentários

Chamar o Add método gera o CollectionChanged evento.

Aplica-se a

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.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object) As Binding

Parâmetros

propertyName
String

O nome da propriedade do controle a ser associada.

dataSource
Object

Um Object que representa a fonte de dados.

dataMember
String

A propriedade ou lista à qual associar.

formattingEnabled
Boolean

true para formatar os dados exibidos; caso contrário, false.

updateMode
DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

nullValue
Object

Quando a fonte de dados tem esse valor, a propriedade associada é definida como DBNull.

Retornos

O Binding recém-criado.

Exceções

A propriedade especificada por propertyName não existe no controle ou é somente leitura.

- ou -

O membro de dados especificado não existe na fonte de dados.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificada está associada a outra associação na coleção.

Comentários

Chamar o Add método gera o CollectionChanged evento.

Aplica-se a

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.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String) As Binding

Parâmetros

propertyName
String

O nome da propriedade do controle a ser associada.

dataSource
Object

Um Object que representa a fonte de dados.

dataMember
String

A propriedade ou lista à qual associar.

formattingEnabled
Boolean

true para formatar os dados exibidos; caso contrário, false.

updateMode
DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

nullValue
Object

Quando a fonte de dados tem esse valor, a propriedade associada é definida como DBNull.

formatString
String

Um ou mais caracteres especificadores de formato que indicam como um valor deve ser exibido.

Retornos

O Binding recém-criado.

Exceções

A propriedade especificada por propertyName não existe no controle ou é somente leitura.

- ou -

O membro de dados especificado não existe na fonte de dados.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificada está associada a outra associação na coleção.

Comentários

Chamar o Add método gera o CollectionChanged evento.

Aplica-se a

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.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString, IFormatProvider formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider) As Binding

Parâmetros

propertyName
String

O nome da propriedade do controle a ser associada.

dataSource
Object

Um Object que representa a fonte de dados.

dataMember
String

A propriedade ou lista à qual associar.

formattingEnabled
Boolean

true para formatar os dados exibidos; caso contrário, false.

updateMode
DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

nullValue
Object

Quando a fonte de dados tem esse valor, a propriedade associada é definida como DBNull.

formatString
String

Um ou mais caracteres especificadores de formato que indicam como um valor deve ser exibido.

formatInfo
IFormatProvider

Uma implementação de IFormatProvider para substituir o comportamento de formatação padrão.

Retornos

O Binding recém-criado.

Exceções

A propriedade especificada por propertyName não existe no controle ou é somente leitura.

- ou -

O membro de dados especificado não existe na fonte de dados.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificada está associada a outra associação na coleção.

Comentários

Chamar o Add método gera o CollectionChanged evento.

Aplica-se a