Compartir vía


ControlBindingsCollection.Add Método

Definición

Agrega un Binding objeto a la colección.

Sobrecargas

Nombre Description
Add(Binding)

Agrega el objeto especificado Binding a la colección.

Add(String, Object, String)

Crea un Binding con el nombre de propiedad de control, el origen de datos y el miembro de datos especificados, y lo agrega a la colección.

Add(String, Object, String, Boolean)

Crea un enlace con el nombre de la propiedad de control, el origen de datos, el miembro de datos y la información sobre si el formato está habilitado y agrega el enlace a la colección.

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

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato, propagando valores al origen de datos en función de la configuración de actualización especificada y agregando el enlace a la colección.

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

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato, propagando valores al origen de datos en función de la configuración de actualización especificada, estableciendo la propiedad en el valor especificado cuando DBNull se devuelve desde el origen de datos y agregando el enlace a la colección.

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

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato con la cadena de formato especificada, propagando valores al origen de datos en función de la configuración de actualización especificada, estableciendo la propiedad en el valor especificado cuando DBNull se devuelve desde el origen de datos y agregando el enlace a la colección.

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

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato con la cadena de formato especificada, propagando valores al origen de datos según la configuración de actualización especificada, estableciendo la propiedad en el valor especificado cuando DBNull se devuelve desde el origen de datos, estableciendo el proveedor de formato especificado, y agregar el enlace a la colección.

Add(Binding)

Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs

Agrega el objeto especificado Binding a la colección.

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

que Binding se va a agregar.

Excepciones

es binding null.

La propiedad de control ya está enlazada a datos.

O bien

Binding no especifica una columna válida de .DataSource

Ejemplos

En el ejemplo de código siguiente se crea una Binding instancia y se usa el Add método para agregar la instancia a ControlBindingsCollection de un TextBox control .

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

Comentarios

La DataSourceUpdateMode propiedad del Binding objeto creado por esta sobrecarga del Add método se establece en el valor de la DefaultDataSourceUpdateMode propiedad .

El CollectionChanged evento se produce cuando se completa el cambio.

Se aplica a

Add(String, Object, String)

Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs

Crea un Binding con el nombre de propiedad de control, el origen de datos y el miembro de datos especificados, y lo agrega a la colección.

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

Nombre de la propiedad de control que se va a enlazar.

dataSource
Object

que Object representa el origen de datos.

dataMember
String

Propiedad o lista a la que se va a enlazar.

Devoluciones

Objeto recién creado Binding.

Excepciones

El valor de binding es null.

ya propertyName está enlazado a datos.

O bien

dataMember no especifica un miembro válido de .dataSource

Ejemplos

En el ejemplo de código siguiente se usa el Add método para agregar tres Binding objetos al ControlBindingsCollection de un TextBox control . ControlBindingsCollection Se obtiene acceso a a través de la DataBindings propiedad de la Control clase .

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

Comentarios

La DataSourceUpdateMode propiedad del Binding objeto creado por esta sobrecarga del Add método se establece en el valor de la DefaultDataSourceUpdateMode propiedad .

Agregar una Binding clase hace que se produzca el CollectionChanged evento.

Se aplica a

Add(String, Object, String, Boolean)

Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs

Crea un enlace con el nombre de la propiedad de control, el origen de datos, el miembro de datos y la información sobre si el formato está habilitado y agrega el enlace a la colección.

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

Nombre de la propiedad de control que se va a enlazar.

dataSource
Object

que Object representa el origen de datos.

dataMember
String

Propiedad o lista a la que se va a enlazar.

formattingEnabled
Boolean

true para dar formato a los datos mostrados; de lo contrario, false.

Devoluciones

Objeto recién creado Binding.

Excepciones

La propiedad dada por propertyName no existe en el control .

O bien

La propiedad especificada es una propiedad de solo lectura.

Si el formato está deshabilitado y propertyName no es una propiedad válida de un control ni una cadena vacía ("").

Se aplica a

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

Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato, propagando valores al origen de datos en función de la configuración de actualización especificada y agregando el enlace a la colección.

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

Nombre de la propiedad de control que se va a enlazar.

dataSource
Object

que Object representa el origen de datos.

dataMember
String

Propiedad o lista a la que se va a enlazar.

formattingEnabled
Boolean

true para dar formato a los datos mostrados; de lo contrario, false.

updateMode
DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

Devoluciones

Objeto recién creado Binding.

Excepciones

La propiedad dada por propertyName no existe en el control o es de solo lectura.

O bien

El miembro de datos especificado no existe en el origen de datos.

O bien

El origen de datos, el miembro de datos o la propiedad de control especificados están asociados a otro enlace de la colección.

Comentarios

Al llamar al método , se Add genera el CollectionChanged evento .

Se aplica a

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

Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato, propagando valores al origen de datos en función de la configuración de actualización especificada, estableciendo la propiedad en el valor especificado cuando DBNull se devuelve desde el origen de datos y agregando el enlace a la colección.

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

Nombre de la propiedad de control que se va a enlazar.

dataSource
Object

que Object representa el origen de datos.

dataMember
String

Propiedad o lista a la que se va a enlazar.

formattingEnabled
Boolean

true para dar formato a los datos mostrados; de lo contrario, false.

updateMode
DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

nullValue
Object

Cuando el origen de datos tiene este valor, la propiedad enlazada se establece en DBNull.

Devoluciones

Objeto recién creado Binding.

Excepciones

La propiedad dada por propertyName no existe en el control o es de solo lectura.

O bien

El miembro de datos especificado no existe en el origen de datos.

O bien

El origen de datos, el miembro de datos o la propiedad de control especificados están asociados a otro enlace de la colección.

Comentarios

Al llamar al método , se Add genera el CollectionChanged evento .

Se aplica a

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

Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato con la cadena de formato especificada, propagando valores al origen de datos en función de la configuración de actualización especificada, estableciendo la propiedad en el valor especificado cuando DBNull se devuelve desde el origen de datos y agregando el enlace a la colección.

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

Nombre de la propiedad de control que se va a enlazar.

dataSource
Object

que Object representa el origen de datos.

dataMember
String

Propiedad o lista a la que se va a enlazar.

formattingEnabled
Boolean

true para dar formato a los datos mostrados; de lo contrario, false.

updateMode
DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

nullValue
Object

Cuando el origen de datos tiene este valor, la propiedad enlazada se establece en DBNull.

formatString
String

Uno o más caracteres de especificador de formato que indican cómo se va a mostrar un valor.

Devoluciones

Objeto recién creado Binding.

Excepciones

La propiedad dada por propertyName no existe en el control o es de solo lectura.

O bien

El miembro de datos especificado no existe en el origen de datos.

O bien

El origen de datos, el miembro de datos o la propiedad de control especificados están asociados a otro enlace de la colección.

Comentarios

Al llamar al método , se Add genera el CollectionChanged evento .

Se aplica a

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

Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs
Source:
ControlBindingsCollection.cs

Crea un enlace que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado, habilitando opcionalmente el formato con la cadena de formato especificada, propagando valores al origen de datos según la configuración de actualización especificada, estableciendo la propiedad en el valor especificado cuando DBNull se devuelve desde el origen de datos, estableciendo el proveedor de formato especificado, y agregar el enlace a la colección.

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

Nombre de la propiedad de control que se va a enlazar.

dataSource
Object

que Object representa el origen de datos.

dataMember
String

Propiedad o lista a la que se va a enlazar.

formattingEnabled
Boolean

true para dar formato a los datos mostrados; de lo contrario, false.

updateMode
DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

nullValue
Object

Cuando el origen de datos tiene este valor, la propiedad enlazada se establece en DBNull.

formatString
String

Uno o más caracteres de especificador de formato que indican cómo se va a mostrar un valor.

formatInfo
IFormatProvider

Implementación de para invalidar el comportamiento de IFormatProvider formato predeterminado.

Devoluciones

Objeto recién creado Binding.

Excepciones

La propiedad dada por propertyName no existe en el control o es de solo lectura.

O bien

El miembro de datos especificado no existe en el origen de datos.

O bien

El origen de datos, el miembro de datos o la propiedad de control especificados están asociados a otro enlace de la colección.

Comentarios

Al llamar al método , se Add genera el CollectionChanged evento .

Se aplica a