Binding Construtores

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

Nome	Description
Binding(String, Object, String)	Inicializa uma nova instância da Binding classe que associa a propriedade de controle indicada ao membro de dados especificado da fonte de dados.
Binding(String, Object, String, Boolean)	Inicializa uma nova instância da Binding classe 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 Binding classe que associa a propriedade de controle especificada ao membro de dados especificado da fonte de dados especificada. Opcionalmente, habilita a formatação 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 Binding classe que associa a propriedade de controle indicada ao membro de dados especificado da fonte de dados especificada. 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 como o valor especificado quando um DBNull é retornado da fonte de dados.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Inicializa uma nova instância da Binding classe que associa a propriedade de controle especificada ao membro de dados especificado da fonte de dados especificada. 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 como o valor especificado quando um DBNull é retornado da fonte de dados.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Inicializa uma nova instância da Binding classe com a propriedade de controle especificada para o membro de dados especificado da fonte de dados especificada. 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; habilita a formatação com a cadeia de caracteres de formato especificada; define a propriedade como o valor especificado quando um DBNull é retornado da fonte de dados; e define o provedor de formato especificado.

Binding(String, Object, String)

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Inicializa uma nova instância da Binding classe que associa a propriedade de controle indicada ao membro de dados especificado da fonte de dados.

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 de 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 nome 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 é anexado 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, uma ArgumentException será gerada quando ela Binding for adicionada à coleção do Control.DataBindings controle.

Confira também

Aplica-se a

Binding(String, Object, String, Boolean)

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Inicializa uma nova instância da Binding classe 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 de 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 fornecida é 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)

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

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 de 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 DataSourceUpdateMode valores.

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 especificada 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 é anexado 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)

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Inicializa uma nova instância da Binding classe que associa a propriedade de controle indicada ao membro de dados especificado da fonte de dados especificada. 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 como o valor especificado quando um DBNull é retornado da 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 de 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 DataSourceUpdateMode valores.

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 especificada 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 é anexado 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)

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Inicializa uma nova instância da Binding classe que associa a propriedade de controle especificada ao membro de dados especificado da fonte de dados especificada. 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 como o valor especificado quando um DBNull é retornado da 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 de 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 DataSourceUpdateMode valores.

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 especificador 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 especificada 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 é anexado 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)

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Origem:: Binding.cs

Inicializa uma nova instância da Binding classe com a propriedade de controle especificada para o membro de dados especificado da fonte de dados especificada. 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; habilita a formatação com a cadeia de caracteres de formato especificada; define a propriedade como 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 de 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 DataSourceUpdateMode valores.

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 especificador de formato que indicam como um valor deve ser exibido.

formatInfo: IFormatProvider

Uma implementação para substituir o comportamento de IFormatProvider 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 especificada 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 é anexado a dois eventos específicos:

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

Aplica-se a

Comentários

Esta página foi útil?