Binding Constructeurs

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la classe Binding.

Surcharges

Nom	Description
Binding(String, Object, String)	Initialise une nouvelle instance de la classe Binding qui lie simple la propriété de contrôle indiquée au membre de données spécifié de la source de données.
Binding(String, Object, String, Boolean)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle indiquée au membre de données spécifié de la source de données et permet éventuellement d’appliquer la mise en forme.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme et propage les valeurs vers la source de données en fonction du paramètre de mise à jour spécifié.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle indiquée au membre de données spécifié de la source de données spécifiée. Vous pouvez éventuellement activer la mise en forme, propager des valeurs à la source de données en fonction du paramètre de mise à jour spécifié et définir la propriété sur la valeur spécifiée lorsqu’une DBNull est retournée à partir de la source de données.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme avec la chaîne de format spécifiée ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; et définit la propriété sur la valeur spécifiée lorsqu’un DBNull est retourné à partir de la source de données.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Initialise une nouvelle instance de la classe Binding avec la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme avec la chaîne de format spécifiée ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; active la mise en forme avec la chaîne de format spécifiée ; définit la propriété sur la valeur spécifiée lorsqu’un DBNull est retourné à partir de la source de données ; et définit le fournisseur de format spécifié.

Binding(String, Object, String)

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Initialise une nouvelle instance de la classe Binding qui lie simple la propriété de contrôle indiquée au membre de données spécifié de la source de données.

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)

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Qui Object représente la source de données.

dataMember: String

Propriété ou liste à lier.

Exceptions

Exception

propertyName n’est ni une propriété valide d’un contrôle ni d’une chaîne vide (« »).

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle.

Exemples

L’exemple de code suivant lie un TextBox contrôle à une colonne de table dans un DataSet nom myDataSet. L’exemple nécessite que vous ayez déclaré myDataSet dans la section déclarations du module.

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

Remarques

Vous pouvez spécifier une instance de l’une des classes suivantes pour la source de données :

DataSet
DataTable
DataView
DataViewManager
BindingSource
Toute classe qui implémente l’interface IList
N’importe quelle classe

Pour plus d’informations sur la création de la chaîne, consultez la BindingdataMember classe.

Lorsque vous créez une liaison à la propriété d’un contrôle, le nouveau Binding inspecte les événements exposés par le contrôle lié et s’attache à deux événements particuliers :

Control.Validating
Événement nommé PropertyNameChanged (par exemple, Control.BackColorChanged)

Si vous tentez de lier à une propriété qui n’existe pas, une ArgumentException opération est levée lorsque l’objet Binding est ajouté à la collection du Control.DataBindings contrôle.

Voir aussi

S’applique à

Binding(String, Object, String, Boolean)

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle indiquée au membre de données spécifié de la source de données et permet éventuellement d’appliquer la mise en forme.

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)

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Qui Object représente la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle.

- ou -

La propriété donnée est une propriété en lecture seule.

Exception

La mise en forme est désactivée et propertyName n’est ni une propriété valide d’un contrôle ni d’une chaîne vide (« »).

S’applique à

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

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: 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)

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

dataSourceUpdateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle.

- ou -

La source de données ou la propriété de contrôle ou membre de données spécifiée sont associées à une autre liaison dans la collection.

Remarques

Vous pouvez spécifier une instance de l’une des classes suivantes pour la source de données :

DataSet
DataTable
DataView
DataViewManager
BindingSource
Toute classe qui implémente l’interface IList
N’importe quelle classe

Pour plus d’informations sur la création de la chaîne, consultez la BindingdataMember classe.

Lorsque vous créez une liaison à la propriété d’un contrôle, le nouveau Binding inspecte les événements exposés par le contrôle lié et s’attache à deux événements particuliers :

Control.Validating.
Événement nommé PropertyNameChanged (par exemple, Control.BackColorChanged)

S’applique à

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

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle indiquée au membre de données spécifié de la source de données spécifiée. Vous pouvez éventuellement activer la mise en forme, propager des valeurs à la source de données en fonction du paramètre de mise à jour spécifié et définir la propriété sur la valeur spécifiée lorsqu’une DBNull est retournée à partir de la source de données.

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)

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

dataSourceUpdateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

nullValue: Object

À Object appliquer à la propriété de contrôle lié si la valeur de la source de données est DBNull.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle.

- ou -

La source de données ou la propriété de contrôle ou membre de données spécifiée sont associées à une autre liaison dans la collection.

Remarques

Vous pouvez spécifier une instance de l’une des classes suivantes pour la source de données :

DataSet
DataTable
DataView
DataViewManager
BindingSource
Toute classe qui implémente l’interface IList
N’importe quelle classe

Pour plus d’informations sur la création de la chaîne, consultez la BindingdataMember classe.

Lorsque vous créez une liaison à la propriété d’un contrôle, le nouveau Binding inspecte les événements exposés par le contrôle lié et s’attache à deux événements particuliers :

Control.Validating
Événement nommé PropertyNameChanged (par exemple, Control.BackColorChanged)

S’applique à

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

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Initialise une nouvelle instance de la classe Binding qui lie la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme avec la chaîne de format spécifiée ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; et définit la propriété sur la valeur spécifiée lorsqu’un DBNull est retourné à partir de la source de données.

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)

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

dataSourceUpdateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

nullValue: Object

À Object appliquer à la propriété de contrôle lié si la valeur de la source de données est DBNull.

formatString: String

Un ou plusieurs caractères spécificateur de format qui indiquent la façon dont une valeur doit être affichée.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle.

- ou -

La source de données ou la propriété de contrôle ou membre de données spécifiée sont associées à une autre liaison dans la collection.

Remarques

Vous pouvez spécifier une instance de l’une des classes suivantes pour la source de données :

DataSet
DataTable
DataView
DataViewManager
BindingSource
Toute classe qui implémente l’interface IList
N’importe quelle classe

Pour plus d’informations sur la création de la chaîne, consultez la BindingdataMember classe.

Lorsque vous créez une liaison à la propriété d’un contrôle, le nouveau Binding inspecte les événements exposés par le contrôle lié et s’attache à deux événements particuliers :

Control.Validating
Événement nommé PropertyNameChanged (par exemple, Control.BackColorChanged)

S’applique à

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

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Source:: Binding.cs

Initialise une nouvelle instance de la classe Binding avec la propriété de contrôle spécifiée au membre de données spécifié de la source de données spécifiée. Active éventuellement la mise en forme avec la chaîne de format spécifiée ; propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié ; active la mise en forme avec la chaîne de format spécifiée ; définit la propriété sur la valeur spécifiée lorsqu’un DBNull est retourné à partir de la source de données ; et définit le fournisseur de format spécifié.

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)

Paramètres

propertyName: String

Nom de la propriété de contrôle à lier.

dataSource: Object

Représentant Object la source de données.

dataMember: String

Propriété ou liste à lier.

formattingEnabled: Boolean

true pour mettre en forme les données affichées ; sinon, false.

dataSourceUpdateMode: DataSourceUpdateMode

Une des DataSourceUpdateMode valeurs.

nullValue: Object

À Object appliquer à la propriété de contrôle lié si la valeur de la source de données est DBNull.

formatString: String

Un ou plusieurs caractères spécificateur de format qui indiquent la façon dont une valeur doit être affichée.

formatInfo: IFormatProvider

Implémentation de remplacement du comportement de IFormatProvider mise en forme par défaut.

Exceptions

ArgumentException

La propriété donnée par propertyName n’existe pas sur le contrôle.

- ou -

La source de données ou la propriété de contrôle ou membre de données spécifiée sont associées à une autre liaison dans la collection.

Remarques

Vous pouvez spécifier une instance de l’une des classes suivantes pour la source de données :

DataSet
DataTable
DataView
DataViewManager
BindingSource
Toute classe qui implémente l’interface IList
N’importe quelle classe

Pour plus d’informations sur la création de la chaîne, consultez la BindingdataMember classe.

Lorsque vous créez une liaison à la propriété d’un contrôle, le nouveau Binding inspecte les événements exposés par le contrôle lié et s’attache à deux événements particuliers :

Control.Validating
Événement nommé PropertyNameChanged (par exemple, Control.BackColorChanged)

S’applique à

Commentaires

Cette page a-t-elle été utile ?