Binding Construtores

Definição

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 (string propertyName, object dataSource, string dataMember);
public Binding (string propertyName, object? dataSource, string? dataMember);

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

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

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 = 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");
}

Comentários

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

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:

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

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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 (string propertyName, object dataSource, string dataMember, bool formattingEnabled);
public Binding (string propertyName, object? dataSource, string? dataMember, bool formattingEnabled);

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

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

- ou -

A propriedade especificada é uma propriedade somente leitura.

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

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

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

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:

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:

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

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

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:

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:

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

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

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:

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:

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

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

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

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:

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:

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9