Binding Construtores

Definição

Espaço de Nomes:: System.Windows.Forms

Assemblagem:: System.Windows.Forms.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicializa uma nova instância da Binding classe.

Sobrecargas

Name	Description
Binding(String, Object, String)	Inicializa uma nova instância da Binding classe que simplesmente associa a propriedade de controlo 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 controlo indicada ao membro de dados especificado da fonte de dados e, opcionalmente, permite a aplicação da formatação.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Inicializa uma nova instância da Binding classe que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada. Opcionalmente, permite 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 controlo indicada ao membro de dados especificado da fonte de dados especificada. Opcionalmente, ativa 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 a DBNull é devolvido 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 controlo especificada ao membro de dados especificado da fonte de dados especificada. Opcionalmente, permite formatação com a string de formato especificada; propaga valores para a fonte de dados com base na definição de atualização especificada; e define a propriedade para o valor especificado quando a DBNull é devolvido 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 controlo especificada para o membro de dados especificado da fonte de dados especificada. Opcionalmente, permite formatação com a string de formato especificada; propaga valores para a fonte de dados com base na definição de atualização especificada; permite formatação com a cadeia de formato especificada; define a propriedade para o valor especificado quando a DBNull é devolvido da fonte de dados; e define o fornecedor de formato especificado.

Binding(String, Object, String)

Inicializa uma nova instância da Binding classe que simplesmente associa a propriedade de controlo 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);

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 controlo a vincular.

dataSource: Object

E Object que representa a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

Exceções

Exception

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

ArgumentException

A propriedade dada por propertyName não existe no controlo.

Exemplos

O exemplo de código seguinte associa um TextBox controlo a uma coluna de tabela num DataSet .myDataSet O exemplo exige que tenhas declarado myDataSet na secção de 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

Observações

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 aula para mais informações sobre como criar a dataMember corda.

Quando cria uma ligação à propriedade de um controlo, o novo Binding inspeciona os eventos expostos pelo controlo ligado e liga-se a dois eventos particulares:

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

Se tentar vincular a uma propriedade que não existe, um ArgumentException será lançado quando o Binding for adicionado à coleção do Control.DataBindings controlo.

Ver também

Aplica-se a

Binding(String, Object, String, Boolean)

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

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

O nome da propriedade de controlo a vincular.

dataSource: Object

E Object que representa a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo.

-ou-

A propriedade dada é uma propriedade de apenas leitura.

Exception

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

Aplica-se a

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

Inicializa uma nova instância da Binding classe que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada. Opcionalmente, permite a formatação 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);

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 controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

dataSourceUpdateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo.

-ou-

A fonte de dados, membro de dados ou propriedade de controlo especificada está associada a outra ligação na coleção.

Observações

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 aula para mais informações sobre como criar a dataMember corda.

Quando cria uma ligação à propriedade de um controlo, o novo Binding inspeciona os eventos expostos pelo controlo ligado e liga-se a dois eventos particulares:

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 Binding classe que associa a propriedade de controlo indicada ao membro de dados especificado da fonte de dados especificada. Opcionalmente, ativa 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 a DBNull é devolvido 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);

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 controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

dataSourceUpdateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

nullValue: Object

A Object ser aplicada à propriedade de controlo limitada se o valor da fonte de dados for DBNull.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo.

-ou-

A fonte de dados, membro de dados ou propriedade de controlo especificada está associada a outra ligação na coleção.

Observações

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 aula para mais informações sobre como criar a dataMember corda.

Quando cria uma ligação à propriedade de um controlo, o novo Binding inspeciona os eventos expostos pelo controlo ligado e liga-se a dois eventos particulares:

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 Binding classe que associa a propriedade de controlo especificada ao membro de dados especificado da fonte de dados especificada. Opcionalmente, permite formatação com a string de formato especificada; propaga valores para a fonte de dados com base na definição de atualização especificada; e define a propriedade para o valor especificado quando a DBNull é devolvido 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);

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 controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

dataSourceUpdateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

nullValue: Object

A Object ser aplicada à propriedade de controlo limitada 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 dada por propertyName não existe no controlo.

-ou-

A fonte de dados, membro de dados ou propriedade de controlo especificada está associada a outra ligação na coleção.

Observações

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 aula para mais informações sobre como criar a dataMember corda.

Quando cria uma ligação à propriedade de um controlo, o novo Binding inspeciona os eventos expostos pelo controlo ligado e liga-se a dois eventos particulares:

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 Binding classe com a propriedade de controlo especificada para o membro de dados especificado da fonte de dados especificada. Opcionalmente, permite formatação com a string de formato especificada; propaga valores para a fonte de dados com base na definição de atualização especificada; permite formatação com a cadeia de formato especificada; define a propriedade para o valor especificado quando a DBNull é devolvido da fonte de dados; e define o fornecedor 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

O nome da propriedade de controlo a vincular.

dataSource: Object

E representa Object a fonte de dados.

dataMember: String

A propriedade ou a lista a que se deve vincular.

formattingEnabled: Boolean

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

dataSourceUpdateMode: DataSourceUpdateMode

Um dos DataSourceUpdateMode valores.

nullValue: Object

A Object ser aplicada à propriedade de controlo limitada 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 sobrepor o comportamento de formatação padrão.

Exceções

ArgumentException

A propriedade dada por propertyName não existe no controlo.

-ou-

A fonte de dados, membro de dados ou propriedade de controlo especificada está associada a outra ligação na coleção.

Observações

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 aula para mais informações sobre como criar a dataMember corda.

Quando cria uma ligação à propriedade de um controlo, o novo Binding inspeciona os eventos expostos pelo controlo ligado e liga-se a dois eventos particulares:

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

Aplica-se a

Comentários

Esta página foi útil?