Compartir a través de


Binding Constructores

Definición

Inicializa una nueva instancia de la clase Binding.

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.

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.

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. Habilita opcionalmente el formato y propaga valores al origen de datos basándose en la configuración de actualización especificada.

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. 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.

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. 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.

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. 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.

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.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);
public Binding (string propertyName, object dataSource, 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.

dataSource
Object

Object que representa el origen de datos.

dataMember
String

Propiedad o lista con la que se va a enlazar.

Excepciones

propertyName no es una propiedad válida de un control ni tampoco es una cadena vacía ("").

La propiedad proporcionada por propertyName no existe en el control.

Ejemplos

En el ejemplo de código siguiente se enlaza un TextBox control a una columna de tabla en un DataSet denominado myDataSet. El ejemplo requiere que haya declarado myDataSet en la sección declaraciones del módulo.

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:

Consulte la Binding clase para obtener más información sobre cómo crear la dataMember cadena.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se adjunta a dos eventos concretos:

Si intenta enlazar a una propiedad que no existe, se producirá una ArgumentException excepción cuando Binding se agregue a la colección del Control.DataBindings control.

Consulte también

Se aplica a

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.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);
public Binding (string propertyName, object dataSource, 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.

dataSource
Object

Object que representa el origen de datos.

dataMember
String

Propiedad o lista con la que se va a enlazar.

formattingEnabled
Boolean

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

Excepciones

La propiedad proporcionada por propertyName no existe en el control.

o bien

La propiedad especificada es una propiedad de sólo lectura.

La aplicación de formato está deshabilitada y propertyName no es una propiedad válida de un control ni una cadena vacía ("").

Se aplica a

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. Habilita opcionalmente el formato y propaga valores al origen de datos basándose en la configuración de actualización especificada.

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);
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
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode)

Parámetros

propertyName
String

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

dataSource
Object

Object que representa el origen de datos.

dataMember
String

Propiedad o lista con la que se va a enlazar.

formattingEnabled
Boolean

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

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.

o bien

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

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:

Consulte la Binding clase para obtener más información sobre cómo crear la dataMember cadena.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se adjunta a dos eventos concretos:

Se aplica a

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. 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.

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);
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
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object)

Parámetros

propertyName
String

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

dataSource
Object

Object que representa el origen de datos.

dataMember
String

Propiedad o lista con la que se va a enlazar.

formattingEnabled
Boolean

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

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode.

nullValue
Object

Object que se va a aplicar a la propiedad del control enlazado si el valor de origen de datos es DBNull.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.

o bien

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

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:

Consulte la Binding clase para obtener más información sobre cómo crear la dataMember cadena.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se adjunta a dos eventos concretos:

Se aplica a

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. 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.

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);
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
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String)

Parámetros

propertyName
String

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

dataSource
Object

Object que representa el origen de datos.

dataMember
String

Propiedad o lista con la que se va a enlazar.

formattingEnabled
Boolean

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

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode.

nullValue
Object

Object que se va a aplicar a la propiedad del control enlazado si el valor de origen de datos es DBNull.

formatString
String

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

Excepciones

La propiedad proporcionada por propertyName no existe en el control.

o bien

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

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:

Consulte la Binding clase para obtener más información sobre cómo crear la dataMember cadena.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se adjunta a dos eventos concretos:

Se aplica a

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. 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.

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);
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
Public Sub New (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, dataSourceUpdateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider)

Parámetros

propertyName
String

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

dataSource
Object

Object que representa el origen de datos.

dataMember
String

Propiedad o lista con la que se va a enlazar.

formattingEnabled
Boolean

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

dataSourceUpdateMode
DataSourceUpdateMode

Uno de los valores de DataSourceUpdateMode.

nullValue
Object

Object que se va a aplicar a la propiedad del control enlazado si el valor de origen de datos es DBNull.

formatString
String

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

formatInfo
IFormatProvider

Una implementación de IFormatProvider para reemplazar el comportamiento predeterminado de formato.

Excepciones

La propiedad proporcionada por propertyName no existe en el control.

o bien

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

Comentarios

Puede especificar una instancia de cualquiera de las siguientes clases para el origen de datos:

Consulte la Binding clase para obtener más información sobre cómo crear la dataMember cadena.

Cuando se crea un enlace a la propiedad de un control, el nuevo Binding inspecciona los eventos expuestos por el control enlazado y se adjunta a dos eventos concretos:

Se aplica a