Binding Constructores

Definición

Inicializa una nueva instancia de la clase Binding.Initializes a new instance of the Binding class.

Sobrecargas

Binding(String, Object, String)

Inicializa una nueva instancia de la clase Binding que establece un enlace sencillo entre la propiedad del control especificado y el miembro de datos especificado del origen de datos.Initializes a new instance of the Binding class that simple-binds the indicated control property to the specified data member of the data source.

Binding(String, Object, String, Boolean)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad del control indicada al miembro de datos especificado del origen de datos y, opcionalmente, permite aplicar formato.Initializes a new instance of the Binding class that binds the indicated control property to the specified data member of the data source, and optionally enables formatting to be applied.

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad del control especificada con el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class that binds the specified control property to the specified data member of the specified data source. Habilita opcionalmente el formato y propaga valores al origen de datos basándose en la configuración de actualización especificada.Optionally enables formatting and propagates values to the data source based on the specified update setting.

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad indicada del control con el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class that binds the indicated control property to the specified data member of the specified data source. Habilita opcionalmente el formato, propaga valores al origen de datos basándose en la configuración de actualización especificada y establece la propiedad en el valor especificado cuando se devuelve DBNull desde el origen de datos.Optionally enables formatting, propagates values to the data source based on the specified update setting, and sets the property to the specified value when a DBNull is returned from the data source.

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad del control especificada con el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class that binds the specified control property to the specified data member of the specified data source. Opcionalmente, habilita el formato con la cadena de formato especificada, propaga valores al origen de datos según la configuración de actualización especificada y establece la propiedad en el valor especificado cuando se devuelve DBNull desde el origen de datos.Optionally enables formatting with the specified format string; propagates values to the data source based on the specified update setting; and sets the property to the specified value when a DBNull is returned from the data source.

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

Inicializa una nueva instancia de la clase Binding con la propiedad del control especificada en el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class with the specified control property to the specified data member of the specified data source. Habilita opcionalmente el formato con la cadena de formato especificada, propaga valores al origen de datos según la configuración de actualización especificada, habilita el formato con la cadena de formato especificada, establece la propiedad en el valor especificado cuando se devuelve DBNull desde el origen de datos y establece el proveedor de formato especificado.Optionally enables formatting with the specified format string; propagates values to the data source based on the specified update setting; enables formatting with the specified format string; sets the property to the specified value when a DBNull is returned from the data source; and sets the specified format provider.

Binding(String, Object, String)

Inicializa una nueva instancia de la clase Binding que establece un enlace sencillo entre la propiedad del control especificado y el miembro de datos especificado del origen de datos.Initializes a new instance of the Binding class that simple-binds the indicated control property to the specified data member of the data source.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);
public Binding (string propertyName, object dataSource, string dataMember);
new System.Windows.Forms.Binding : string * obj * string -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String)

Parámetros

propertyName
String

Nombre de la propiedad de control que se va a enlazar.The name of the control property to bind.

dataSource
Object

Object que representa el origen de datos.An Object that represents the data source.

dataMember
String

Propiedad o lista con la que se va a enlazar.The property or list to bind to.

Excepciones

propertyName no es una propiedad válida de un control ni tampoco es una cadena vacía ("").propertyName is neither a valid property of a control nor an empty string ("").

La propiedad proporcionada por propertyName no existe en el control.The property given by propertyName does not exist on the control.

Ejemplos

En el ejemplo de código siguiente se enlaza un control de TextBox a una columna de tabla de un DataSet denominado myDataSet.The following code example binds a TextBox control to a table column in a DataSet named myDataSet. El ejemplo requiere que se haya declarado myDataSet en la sección de declaraciones del módulo.The example requires that you have declared myDataSet in the declarations section of the module.

private:
   void CreateDataSet()
   {
      myDataSet = gcnew DataSet( "myDataSet" );
      /* Populates the DataSet with tables, relations, and 
         constraints. */
   }

   void BindTextBoxToDataSet()
   {
      /* Binds a TextBox control to a DataColumn named
      CompanyName in the DataTable named Suppliers. */
      textBox1->DataBindings->Add(
         "Text", myDataSet, "Suppliers.CompanyName" );
   }
private void CreateDataSet()
{
   myDataSet = new DataSet("myDataSet");
   /* Populates the DataSet with tables, relations, and 
      constraints. */
}

private void BindTextBoxToDataSet()
{
   /* Binds a TextBox control to a DataColumn named
   CompanyName in the DataTable named Suppliers. */
   textBox1.DataBindings.Add
   ("Text", myDataSet, "Suppliers.CompanyName");
}
   
Private Sub CreateDataSet
   myDataSet = new DataSet("myDataSet")
   ' Populates the DataSet with tables, relations, and
   ' constraints.
End Sub

Private Sub BindTextBoxToDataSet 
   ' Binds a TextBox control to a column in the DataSet.
   textBox1.DataBindings.Add _
   ("Text", myDataSet, "Suppliers.CompanyName")
End Sub

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:You can specify an instance of any of the following classes for the data source:

Vea la clase Binding para obtener más información sobre la creación de la cadena de dataMember.See the Binding class for more information about creating the dataMember string.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se asocia a dos eventos determinados:When you create a binding to a control's property, the new Binding inspects the events exposed by the bound control and attaches to two particular events:

Si intenta enlazar a una propiedad que no existe, se producirá una ArgumentException cuando el Binding se agregue a la colección de Control.DataBindings del control.If you attempt to bind to a property that does not exist, an ArgumentException will be thrown when the Binding is added to the control's Control.DataBindings collection.

Consulte también:

Binding(String, Object, String, Boolean)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad del control indicada al miembro de datos especificado del origen de datos y, opcionalmente, permite aplicar formato.Initializes a new instance of the Binding class that binds the indicated control property to the specified data member of the data source, and optionally enables formatting to be applied.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled);
new System.Windows.Forms.Binding : string * obj * string * bool -> System.Windows.Forms.Binding
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean)

Parámetros

propertyName
String

Nombre de la propiedad de control que se va a enlazar.The name of the control property to bind.

dataSource
Object

Object que representa el origen de datos.An Object that represents the data source.

dataMember
String

Propiedad o lista con la que se va a enlazar.The property or list to bind to.

formattingEnabled
Boolean

true para aplicar formato a los datos mostrados; de lo contrario, es false.true to format the displayed data; otherwise, false.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.The property given by propertyName does not exist on the control.

O bien,-or- La propiedad especificada es una propiedad de sólo lectura.The property given is a read-only property.

La aplicación de formato está deshabilitada y propertyName no es una propiedad válida de un control ni una cadena vacía ("").Formatting is disabled and propertyName is neither a valid property of a control nor an empty string ("").

Binding(String, Object, String, Boolean, DataSourceUpdateMode)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad del control especificada con el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class that binds the specified control property to the specified data member of the specified data source. Habilita opcionalmente el formato y propaga valores al origen de datos basándose en la configuración de actualización especificada.Optionally enables formatting and propagates values to the data source based on the specified update setting.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding

Parámetros

propertyName
String

Nombre de la propiedad de control que se va a enlazar.The name of the control property to bind.

dataSource
Object

Object que representa el origen de datos.An Object representing the data source.

dataMember
String

Propiedad o lista con la que se va a enlazar.The property or list to bind to.

formattingEnabled
Boolean

true para aplicar formato a los datos mostrados; de lo contrario, es false.true to format the displayed data; otherwise, false.

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode .One of the DataSourceUpdateMode values.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.The property given by propertyName does not exist on the control.

O bien,-or- El miembro de datos, el origen de datos o la propiedad del control especificados están asociados a otro enlace de la colección.The data source or data member or control property specified are associated with another binding in the collection.

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:You can specify an instance of any of the following classes for the data source:

Vea la clase Binding para obtener más información sobre la creación de la cadena de dataMember.See the Binding class for more information about creating the dataMember string.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se asocia a dos eventos determinados:When you create a binding to a control's property, the new Binding inspects the events exposed by the bound control and attaches to two particular events:

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad indicada del control con el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class that binds the indicated control property to the specified data member of the specified data source. Habilita opcionalmente el formato, propaga valores al origen de datos basándose en la configuración de actualización especificada y establece la propiedad en el valor especificado cuando se devuelve DBNull desde el origen de datos.Optionally enables formatting, propagates values to the data source based on the specified update setting, and sets the property to the specified value when a DBNull is returned from the data source.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding

Parámetros

propertyName
String

Nombre de la propiedad de control que se va a enlazar.The name of the control property to bind.

dataSource
Object

Object que representa el origen de datos.An Object representing the data source.

dataMember
String

Propiedad o lista con la que se va a enlazar.The property or list to bind to.

formattingEnabled
Boolean

true para aplicar formato a los datos mostrados; de lo contrario, es false.true to format the displayed data; otherwise, false.

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode .One of the DataSourceUpdateMode values.

nullValue
Object

Object que se va a aplicar a la propiedad del control enlazado si el valor de origen de datos es DBNull.The Object to be applied to the bound control property if the data source value is DBNull.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.The property given by propertyName does not exist on the control.

O bien,-or- El miembro de datos, el origen de datos o la propiedad del control especificados están asociados a otro enlace de la colección.The data source or data member or control property specified are associated with another binding in the collection.

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:You can specify an instance of any of the following classes for the data source:

Vea la clase Binding para obtener más información sobre la creación de la cadena de dataMember.See the Binding class for more information about creating the dataMember string.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se asocia a dos eventos determinados:When you create a binding to a control's property, the new Binding inspects the events exposed by the bound control and attaches to two particular events:

Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad del control especificada con el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class that binds the specified control property to the specified data member of the specified data source. Opcionalmente, habilita el formato con la cadena de formato especificada, propaga valores al origen de datos según la configuración de actualización especificada y establece la propiedad en el valor especificado cuando se devuelve DBNull desde el origen de datos.Optionally enables formatting with the specified format string; propagates values to the data source based on the specified update setting; and sets the property to the specified value when a DBNull is returned from the data source.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue, string formatString);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding

Parámetros

propertyName
String

Nombre de la propiedad de control que se va a enlazar.The name of the control property to bind.

dataSource
Object

Object que representa el origen de datos.An Object representing the data source.

dataMember
String

Propiedad o lista con la que se va a enlazar.The property or list to bind to.

formattingEnabled
Boolean

true para aplicar formato a los datos mostrados; de lo contrario, es false.true to format the displayed data; otherwise, false.

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode .One of the DataSourceUpdateMode values.

nullValue
Object

Object que se va a aplicar a la propiedad del control enlazado si el valor de origen de datos es DBNull.The Object to be applied to the bound control property if the data source value is DBNull.

formatString
String

Uno o más caracteres especificadores de formato que indican cómo se va a mostrar un valor.One or more format specifier characters that indicate how a value is to be displayed.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.The property given by propertyName does not exist on the control.

O bien,-or- El miembro de datos, el origen de datos o la propiedad del control especificados están asociados a otro enlace de la colección.The data source or data member or control property specified are associated with another binding in the collection.

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:You can specify an instance of any of the following classes for the data source:

Vea la clase Binding para obtener más información sobre la creación de la cadena de dataMember.See the Binding class for more information about creating the dataMember string.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se asocia a dos eventos determinados:When you create a binding to a control's property, the new Binding inspects the events exposed by the bound control and attaches to two particular events:

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

Inicializa una nueva instancia de la clase Binding con la propiedad del control especificada en el miembro de datos especificado del origen de datos indicado.Initializes a new instance of the Binding class with the specified control property to the specified data member of the specified data source. Habilita opcionalmente el formato con la cadena de formato especificada, propaga valores al origen de datos según la configuración de actualización especificada, habilita el formato con la cadena de formato especificada, establece la propiedad en el valor especificado cuando se devuelve DBNull desde el origen de datos y establece el proveedor de formato especificado.Optionally enables formatting with the specified format string; propagates values to the data source based on the specified update setting; enables formatting with the specified format string; sets the property to the specified value when a DBNull is returned from the data source; and sets the specified format provider.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode dataSourceUpdateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);
public Binding (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode dataSourceUpdateMode, object nullValue, string formatString, IFormatProvider formatInfo);
new System.Windows.Forms.Binding : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding

Parámetros

propertyName
String

Nombre de la propiedad de control que se va a enlazar.The name of the control property to bind.

dataSource
Object

Object que representa el origen de datos.An Object representing the data source.

dataMember
String

Propiedad o lista con la que se va a enlazar.The property or list to bind to.

formattingEnabled
Boolean

true para aplicar formato a los datos mostrados; de lo contrario, es false.true to format the displayed data; otherwise, false.

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode .One of the DataSourceUpdateMode values.

nullValue
Object

Object que se va a aplicar a la propiedad del control enlazado si el valor de origen de datos es DBNull.The Object to be applied to the bound control property if the data source value is DBNull.

formatString
String

Uno o más caracteres especificadores de formato que indican cómo se va a mostrar un valor.One or more format specifier characters that indicate how a value is to be displayed.

formatInfo
IFormatProvider

Una implementación de IFormatProvider para reemplazar el comportamiento predeterminado de formato.An implementation of IFormatProvider to override default formatting behavior.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.The property given by propertyName does not exist on the control.

O bien,-or- El miembro de datos, el origen de datos o la propiedad del control especificados están asociados a otro enlace de la colección.The data source or data member or control property specified are associated with another binding in the collection.

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:You can specify an instance of any of the following classes for the data source:

Vea la clase Binding para obtener más información sobre la creación de la cadena de dataMember.See the Binding class for more information about creating the dataMember string.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se asocia a dos eventos determinados:When you create a binding to a control's property, the new Binding inspects the events exposed by the bound control and attaches to two particular events:

Se aplica a