Binding Construtores

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Inicializa uma nova instância da classe Binding.

Sobrecargas

Binding(String, Object, String)	Inicializa uma nova instância da classe Binding que gera uma associação simples entre a propriedade do controle indicada e o membro de dados da fonte de dados especificado.
Binding(String, Object, String, Boolean)	Inicializa uma nova instância da classe Binding que associa a propriedade de controle indicada ao membro de dados especificado da fonte de dados e, opcionalmente, permite que a formatação seja aplicada.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Inicializa uma nova instância da classe Binding que associa a propriedade do controle indicada ao membro de dados da fonte de dados especificado. Opcionalmente, permite formatar e propaga valores para a fonte de dados com base na configuração de atualização especificada.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Inicializa uma nova instância da classe Binding que associa a propriedade do controle indicada ao membro de dados da fonte de dados especificado. Opcionalmente, habilita a formatação, propaga valores para a fonte de dados com base na configuração de atualização especificada e define a propriedade para o valor especificado quando um DBNull é retornado de uma fonte de dados.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Inicializa uma nova instância da classe Binding que associa a propriedade do controle indicada ao membro de dados da fonte de dados especificado. Opcionalmente, habilita a formatação com a cadeia de caracteres de formato especificada, propaga valores para a fonte de dados com base na configuração de atualização especificada e define a propriedade para o valor especificado quando um DBNull é retornado de uma fonte de dados.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Inicializa uma nova instância da classe Binding com a propriedade do controle especificada para o membro de dados especificado da fonte de dados especificada. Opcionalmente, permite a formatação com a cadeia de formato especificada; propaga valores para a fonte de dados de acordo com a configuração de atualização especificada; permite a formatação com a cadeia de formato especificada; define a propriedade com o valor especificado quando um DBNull é retornado da fonte de dados e define o provedor de formato especificado.

Binding(String, Object, String)

Inicializa uma nova instância da classe Binding que gera uma associação simples entre a propriedade do controle indicada e o membro de dados da fonte de dados especificado.

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

O nome da propriedade do controle a ser associada.

dataSource: Object

Um Object que representa a fonte de dados.

dataMember: String

A propriedade ou lista à qual associar.

Exceções

Exception

propertyName não é uma propriedade válida de um controle nem uma cadeia de caracteres vazia ("").

ArgumentException

A propriedade fornecida por propertyName não existe no controle.

Exemplos

O exemplo de código a seguir associa um TextBox controle a uma coluna de tabela em um DataSet chamado myDataSet. O exemplo requer que você tenha declarado myDataSet na seção declarações do 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

Comentários

Você pode especificar uma instância de qualquer uma das seguintes classes para a fonte de dados:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualquer classe que implemente a IList interface
Qualquer classe

Consulte a Binding classe para obter mais informações sobre como criar a dataMember cadeia de caracteres.

Quando você cria uma associação à propriedade de um controle, o novo Binding inspeciona os eventos expostos pelo controle associado e se anexa a dois eventos específicos:

Control.Validating
Um evento chamado PropertyNameChanged (por exemplo, Control.BackColorChanged)

Se você tentar associar a uma propriedade que não existe, um ArgumentException será gerado quando o Binding for adicionado à coleção do Control.DataBindings controle.

Confira também

Aplica-se a

Binding(String, Object, String, Boolean)

Inicializa uma nova instância da classe Binding que associa a propriedade de controle indicada ao membro de dados especificado da fonte de dados e, opcionalmente, permite que a formatação seja aplicada.

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

O nome da propriedade do controle a ser associada.

dataSource: Object

Um Object que representa a fonte de dados.

dataMember: String

A propriedade ou lista à qual associar.

formattingEnabled: Boolean

true para formatar os dados exibidos; caso contrário, false.

Exceções

ArgumentException

A propriedade fornecida por propertyName não existe no controle.

- ou -

A propriedade especificada é uma propriedade somente leitura.

Exception

A formatação está desabilitada e propertyName não é uma propriedade válida de um controle nem uma cadeia de caracteres vazia ("").

Aplica-se a

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

Inicializa uma nova instância da classe Binding que associa a propriedade do controle indicada ao membro de dados da fonte de dados especificado. Opcionalmente, permite formatar e propaga valores para a fonte de dados com base na configuração de atualização 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

O nome da propriedade do controle a ser associada.

dataSource: Object

Um Object que representa a fonte de dados.

dataMember: String

A propriedade ou lista à qual associar.

formattingEnabled: Boolean

true para formatar os dados exibidos; caso contrário, false.

dataSourceUpdateMode: DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

Exceções

ArgumentException

A propriedade fornecida por propertyName não existe no controle.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificados estão associados a outra associação na coleção.

Comentários

Você pode especificar uma instância de qualquer uma das seguintes classes para a fonte de dados:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualquer classe que implemente a IList interface
Qualquer classe

Consulte a Binding classe para obter mais informações sobre como criar a dataMember cadeia de caracteres.

Quando você cria uma associação à propriedade de um controle, o novo Binding inspeciona os eventos expostos pelo controle associado e se anexa a dois eventos específicos:

Control.Validating.
Um evento chamado PropertyNameChanged (por exemplo, Control.BackColorChanged)

Aplica-se a

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

Inicializa uma nova instância da classe Binding que associa a propriedade do controle indicada ao membro de dados da fonte de dados especificado. Opcionalmente, habilita a formatação, propaga valores para a fonte de dados com base na configuração de atualização especificada e define a propriedade para o valor especificado quando um DBNull é retornado de uma fonte de dados.

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

O nome da propriedade do controle a ser associada.

dataSource: Object

Um Object que representa a fonte de dados.

dataMember: String

A propriedade ou lista à qual associar.

formattingEnabled: Boolean

true para formatar os dados exibidos; caso contrário, false.

dataSourceUpdateMode: DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

nullValue: Object

O Object a ser aplicado à propriedade de controle associado se o valor da fonte de dados for DBNull.

Exceções

ArgumentException

A propriedade fornecida por propertyName não existe no controle.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificados estão associados a outra associação na coleção.

Comentários

Você pode especificar uma instância de qualquer uma das seguintes classes para a fonte de dados:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualquer classe que implemente a IList interface
Qualquer classe

Consulte a Binding classe para obter mais informações sobre como criar a dataMember cadeia de caracteres.

Quando você cria uma associação à propriedade de um controle, o novo Binding inspeciona os eventos expostos pelo controle associado e se anexa a dois eventos específicos:

Control.Validating
Um evento chamado PropertyNameChanged (por exemplo, Control.BackColorChanged)

Aplica-se a

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

Inicializa uma nova instância da classe Binding que associa a propriedade do controle indicada ao membro de dados da fonte de dados especificado. Opcionalmente, habilita a formatação com a cadeia de caracteres de formato especificada, propaga valores para a fonte de dados com base na configuração de atualização especificada e define a propriedade para o valor especificado quando um DBNull é retornado de uma fonte de dados.

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

O nome da propriedade do controle a ser associada.

dataSource: Object

Um Object que representa a fonte de dados.

dataMember: String

A propriedade ou lista à qual associar.

formattingEnabled: Boolean

true para formatar os dados exibidos; caso contrário, false.

dataSourceUpdateMode: DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

nullValue: Object

O Object a ser aplicado à propriedade de controle associado se o valor da fonte de dados for DBNull.

formatString: String

Um ou mais caracteres especificadores de formato que indicam como um valor deve ser exibido.

Exceções

ArgumentException

A propriedade fornecida por propertyName não existe no controle.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificados estão associados a outra associação na coleção.

Comentários

Você pode especificar uma instância de qualquer uma das seguintes classes para a fonte de dados:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualquer classe que implemente a IList interface
Qualquer classe

Consulte a Binding classe para obter mais informações sobre como criar a dataMember cadeia de caracteres.

Quando você cria uma associação à propriedade de um controle, o novo Binding inspeciona os eventos expostos pelo controle associado e se anexa a dois eventos específicos:

Control.Validating
Um evento chamado PropertyNameChanged (por exemplo, Control.BackColorChanged)

Aplica-se a

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

Inicializa uma nova instância da classe Binding com a propriedade do controle especificada para o membro de dados especificado da fonte de dados especificada. Opcionalmente, permite a formatação com a cadeia de formato especificada; propaga valores para a fonte de dados de acordo com a configuração de atualização especificada; permite a formatação com a cadeia de formato especificada; define a propriedade com o valor especificado quando um DBNull é retornado da fonte de dados e define o provedor 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

O nome da propriedade do controle a ser associada.

dataSource: Object

Um Object que representa a fonte de dados.

dataMember: String

A propriedade ou lista à qual associar.

formattingEnabled: Boolean

true para formatar os dados exibidos; caso contrário, false.

dataSourceUpdateMode: DataSourceUpdateMode

Um dos valores de DataSourceUpdateMode.

nullValue: Object

O Object a ser aplicado à propriedade de controle associado se o valor da fonte de dados for DBNull.

formatString: String

Um ou mais caracteres especificadores de formato que indicam como um valor deve ser exibido.

formatInfo: IFormatProvider

Uma implementação de IFormatProvider para substituir o comportamento de formatação padrão.

Exceções

ArgumentException

A propriedade fornecida por propertyName não existe no controle.

- ou -

A fonte de dados, o membro de dados ou a propriedade de controle especificados estão associados a outra associação na coleção.

Comentários

Você pode especificar uma instância de qualquer uma das seguintes classes para a fonte de dados:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualquer classe que implemente a IList interface
Qualquer classe

Consulte a Binding classe para obter mais informações sobre como criar a dataMember cadeia de caracteres.

Quando você cria uma associação à propriedade de um controle, o novo Binding inspeciona os eventos expostos pelo controle associado e se anexa a dois eventos específicos:

Control.Validating
Um evento chamado PropertyNameChanged (por exemplo, Control.BackColorChanged)

Aplica-se a

Binding Construtores

Definição

Sobrecargas

Binding(String, Object, String)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Binding(String, Object, String, Boolean)

Parâmetros

Exceções

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

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

Parâmetros

Exceções

Comentários

Aplica-se a

Comentários

Recursos adicionais