ControlBindingsCollection.Add Método

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Acrescenta um a Binding à coleção.

Sobrecargas

Name	Description
Add(Binding)	Adiciona o especificado Binding à coleção.
Add(String, Object, String)	Cria um Binding usando o nome da propriedade de controlo especificado, a fonte de dados e o membro de dados, e adiciona-o à coleção.
Add(String, Object, String, Boolean)	Cria uma ligação com o nome da propriedade de controlo especificada, fonte de dados, membro de dados e informações sobre se a formatação está ativada, e adiciona a ligação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode)	Cria uma ligação que vincula a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, ativando opcionalmente formatação, propagação de valores para a fonte de dados com base na configuração de atualização especificada e adicionando a ligação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Cria uma ligação que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, permitindo opcionalmente formatação, propagação de valores para a fonte de dados com base na configuração de atualização especificada, definição da propriedade para o valor especificado quando DBNull retorna da fonte de dados e adição da ligação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Cria uma ligação que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, ativando opcionalmente a formatação com a cadeia de formato especificada, propagando valores para a fonte de dados com base na definição de atualização especificada, definindo a propriedade para o valor especificado quando DBNull é devolvida da fonte de dados e adicionando a ligação à coleção.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Cria uma ligação que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, ativando opcionalmente a formatação com a string de formato especificada, propagando valores para a fonte de dados com base na definição de atualização especificada, definindo a propriedade para o valor especificado quando DBNull é devolvido da fonte de dados, definindo o fornecedor de formato especificado, e adicionar a encadernação à coleção.

Add(Binding)

Adiciona o especificado Binding à 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 acrescentar.

Exceções

ArgumentNullException

O binding é nulo.

ArgumentException

A propriedade de controlo já está ligada a dados.

-ou-

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

Exemplos

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

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

Observações

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

O CollectionChanged evento ocorre quando a mudança está completa.

Aplica-se a

Add(String, Object, String)

Cria um Binding usando o nome da propriedade de controlo especificado, a fonte de dados e o membro de dados, e adiciona-o à 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);

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 de controlo a vincular.

dataSource: Object

E Object que representa a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

Devoluções

Binding

O recém-criado Binding.

Exceções

ArgumentNullException

O binding é null.

Exception

O propertyName já está ligado aos dados.

-ou-

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

Exemplos

O exemplo de código seguinte utiliza o Add método para adicionar três Binding objetos ao ControlBindingsCollection de um TextBox controlo. O ControlBindingsCollection é acedido através 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

Observações

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

Adicionar a Binding faz com que o CollectionChanged evento aconteça.

Aplica-se a

Add(String, Object, String, Boolean)

Cria uma ligação com o nome da propriedade de controlo especificada, fonte de dados, membro de dados e informações sobre se a formatação está ativada, e adiciona a ligaçã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);

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 de controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

Devoluções

Binding

O recém-criado Binding.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo.

-ou-

A propriedade dada é uma propriedade de apenas leitura.

Exception

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

Aplica-se a

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

Cria uma ligação que vincula a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, ativando opcionalmente formatação, propagação de valores para a fonte de dados com base na configuração de atualização especificada e adicionando a ligaçã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);

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 de controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

updateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

Devoluções

Binding

O recém-criado Binding.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo ou é apenas de leitura.

-ou-

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

-ou-

A fonte de dados, o membro de dados ou a propriedade de controlo especificada estão associados a outra ligação na coleção.

Observações

Chamar o Add método eleva o CollectionChanged evento.

Aplica-se a

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

Cria uma ligação que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, permitindo opcionalmente formatação, propagação de valores para a fonte de dados com base na configuração de atualização especificada, definição da propriedade para o valor especificado quando DBNull retorna da fonte de dados e adição da ligaçã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);

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 de controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

updateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

nullValue: Object

Quando a fonte de dados tem este valor, a propriedade limitada é definida como DBNull.

Devoluções

Binding

O recém-criado Binding.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo ou é apenas de leitura.

-ou-

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

-ou-

A fonte de dados, o membro de dados ou a propriedade de controlo especificada estão associados a outra ligação na coleção.

Observações

Chamar o Add método eleva o CollectionChanged evento.

Aplica-se a

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

Cria uma ligação que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, ativando opcionalmente a formatação com a cadeia de formato especificada, propagando valores para a fonte de dados com base na definição de atualização especificada, definindo a propriedade para o valor especificado quando DBNull é devolvida da fonte de dados e adicionando a ligaçã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);

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 de controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

updateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

nullValue: Object

Quando a fonte de dados tem este valor, a propriedade limitada é definida como DBNull.

formatString: String

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

Devoluções

Binding

O recém-criado Binding.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo ou é apenas de leitura.

-ou-

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

-ou-

A fonte de dados, o membro de dados ou a propriedade de controlo especificada estão associados a outra ligação na coleção.

Observações

Chamar o Add método eleva o CollectionChanged evento.

Aplica-se a

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

Cria uma ligação que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada, ativando opcionalmente a formatação com a string de formato especificada, propagando valores para a fonte de dados com base na definição de atualização especificada, definindo a propriedade para o valor especificado quando DBNull é devolvido da fonte de dados, definindo o fornecedor de formato especificado, e adicionar a encadernaçã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);

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 de controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

updateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

nullValue: Object

Quando a fonte de dados tem este valor, a propriedade limitada é 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 sobrepor o comportamento de formatação padrão.

Devoluções

Binding

O recém-criado Binding.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo ou é apenas de leitura.

-ou-

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

-ou-

A fonte de dados, o membro de dados ou a propriedade de controlo especificada estão associados a outra ligação na coleção.

Observações

Chamar o Add método eleva o CollectionChanged evento.

Aplica-se a

Comentários

Esta página foi útil?