ControlBindingsCollection.Add Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 .