Compartilhar via


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

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 = 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:

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

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

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

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

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

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

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

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

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

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

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