ControlBindingsCollection.Add Método

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

ArgumentNullException

O binding é nulo.

ArgumentException

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

Binding

O Binding recém-criado.

Exceções

ArgumentNullException

O binding é null.

Exception

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

Binding

O Binding recém-criado.

Exceções

ArgumentException

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

- ou -

A propriedade especificada é uma propriedade somente leitura.

Exception

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

Binding

O Binding recém-criado.

Exceções

ArgumentException

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

Binding

O Binding recém-criado.

Exceções

ArgumentException

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

Binding

O Binding recém-criado.

Exceções

ArgumentException

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

Binding

O Binding recém-criado.

Exceções

ArgumentException

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

ControlBindingsCollection.Add Método

Definição

Sobrecargas

Add(Binding)

Parâmetros

Exceções

Exemplos

Comentários

Aplica-se a

Add(String, Object, String)

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Aplica-se a

Add(String, Object, String, Boolean)

Parâmetros

Retornos

Exceções

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

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

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Comentários

Recursos adicionais