Binding Construtores
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.
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. |
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.
- 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:
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:
Um evento chamado PropertyName
Changed
(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
.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 |
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.
- 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 |
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.
- 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:
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:
Um evento chamado PropertyName
Changed
(por exemplo, Control.BackColorChanged)
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 |
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.
- 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:
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:
Um evento chamado PropertyName
Changed
(por exemplo, Control.BackColorChanged)
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 |
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.
- 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:
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:
Um evento chamado PropertyName
Changed
(por exemplo, Control.BackColorChanged)
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 |
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.
- 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:
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:
Um evento chamado PropertyName
Changed
(por exemplo, Control.BackColorChanged)
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 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: