Binding Constructores

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

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

Inicializa una nueva instancia de la clase Binding.

Sobrecargas

Nombre	Description
Binding(String, Object, String)	Inicializa una nueva instancia de la clase Binding que enlaza simplemente la propiedad de control indicada al 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 de 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 de control especificada al miembro de datos especificado del origen de datos especificado. Opcionalmente, habilita el formato y propaga los valores al origen de datos en función de 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 de control indicada al miembro de datos especificado del origen de datos especificado. Opcionalmente, habilita el formato, propaga los valores al origen de datos en función de la configuración de actualización especificada y establece la propiedad en el valor especificado cuando se devuelve un 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 de control especificada al miembro de datos especificado del origen de datos especificado. Opcionalmente, habilita el formato con la cadena de formato especificada; propaga valores al origen de datos en función de la configuración de actualización especificada; y establece la propiedad en el valor especificado cuando se devuelve un 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 de control especificada en el miembro de datos especificado del origen de datos especificado. Opcionalmente, habilita el formato con la cadena de formato especificada; propaga valores al origen de datos en función de 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 un DBNull del origen de datos; y establece el proveedor de formato especificado.

Binding(String, Object, String)

Inicializa una nueva instancia de la clase Binding que enlaza simplemente la propiedad de control indicada al 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);

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

que Object representa el origen de datos.

dataMember: String

Propiedad o lista a la que se va a enlazar.

Excepciones

Exception

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

ArgumentException

La propiedad dada 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 de un DataSet objeto denominado myDataSet. El ejemplo requiere que haya declarado myDataSet en la sección de 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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Cualquier clase que implemente la IList interfaz
Cualquier clase

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

Al crear 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:

Control.Validating
Evento denominado PropertyNameChanged (por ejemplo, Control.BackColorChanged)

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 de 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);

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

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.

Excepciones

ArgumentException

La propiedad dada por propertyName no existe en el control .

O bien

La propiedad especificada es una propiedad de solo lectura.

Exception

El formato está deshabilitado 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)

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

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

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

Excepciones

ArgumentException

La propiedad dada por propertyName no existe en el control .

O bien

El origen de datos o la propiedad de control o miembro de datos 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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Cualquier clase que implemente la IList interfaz
Cualquier clase

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

Al crear 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:

Control.Validating.
Evento denominado PropertyNameChanged (por ejemplo, Control.BackColorChanged)

Se aplica a

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

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad de control indicada al miembro de datos especificado del origen de datos especificado. Opcionalmente, habilita el formato, propaga los valores al origen de datos en función de la configuración de actualización especificada y establece la propiedad en el valor especificado cuando se devuelve un 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);

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

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

nullValue: Object

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

Excepciones

ArgumentException

La propiedad dada por propertyName no existe en el control .

O bien

El origen de datos o la propiedad de control o miembro de datos 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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Cualquier clase que implemente la IList interfaz
Cualquier clase

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

Al crear 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:

Control.Validating
Evento denominado PropertyNameChanged (por ejemplo, Control.BackColorChanged)

Se aplica a

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

Inicializa una nueva instancia de la clase Binding que enlaza la propiedad de control especificada al miembro de datos especificado del origen de datos especificado. Opcionalmente, habilita el formato con la cadena de formato especificada; propaga valores al origen de datos en función de la configuración de actualización especificada; y establece la propiedad en el valor especificado cuando se devuelve un 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);

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

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

nullValue: Object

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

formatString: String

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

Excepciones

ArgumentException

La propiedad dada por propertyName no existe en el control .

O bien

El origen de datos o la propiedad de control o miembro de datos 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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Cualquier clase que implemente la IList interfaz
Cualquier clase

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

Al crear 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:

Control.Validating
Evento denominado PropertyNameChanged (por ejemplo, Control.BackColorChanged)

Se aplica a

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

Inicializa una nueva instancia de la clase Binding con la propiedad de control especificada en el miembro de datos especificado del origen de datos especificado. Opcionalmente, habilita el formato con la cadena de formato especificada; propaga valores al origen de datos en función de 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 un DBNull del 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);

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

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno de los DataSourceUpdateMode valores.

nullValue: Object

que Object se va a aplicar a la propiedad de control enlazada si el valor del origen de datos es 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.

Excepciones

ArgumentException

La propiedad dada por propertyName no existe en el control .

O bien

El origen de datos o la propiedad de control o miembro de datos 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:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Cualquier clase que implemente la IList interfaz
Cualquier clase

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

Al crear 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:

Control.Validating
Evento denominado PropertyNameChanged (por ejemplo, Control.BackColorChanged)

Se aplica a

Comentarios

¿Le ha resultado útil esta página?