Binding Constructeurs

Référence

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

Binding(String, Object, String)	Initialise une nouvelle instance de la classe Binding qui établit une liaison simple de la propriété du contrôle indiquée aux données membres spécifiées de la source de données.
Binding(String, Object, String, Boolean)	Initialise une nouvelle instance de la classe Binding qui lie la propriété du contrôle indiquée aux données membres spécifiées de la source de données et permet éventuellement l'application de la mise en forme.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Initialise une nouvelle instance de la classe Binding qui établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiquée. Active éventuellement la mise en forme et propage les valeurs à 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 établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiquée. Active éventuellement la mise en forme, propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié et affecte à la propriété 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)	Initialise une nouvelle instance de la classe Binding qui établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiqué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 affecte à la propriété la valeur spécifiée lorsque 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é du contrôle spécifiée aux données membres spécifiées de la source de données indiquée. Active éventuellement la mise en forme avec la chaîne de mise en forme 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 mise en forme spécifiée, affecte à la propriété 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)

Initialise une nouvelle instance de la classe Binding qui établit une liaison simple de la propriété du contrôle indiquée aux données membres spécifiées 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é du contrôle à lier.

dataSource: Object

Object représentant la source de données.

dataMember: String

Propriété ou liste à lier.

Exceptions

Exception

propertyName ne doit pas être une propriété valide d'un contrôle ou une chaîne vide ("").

ArgumentException

La propriété fournie par propertyName n'existe pas dans le contrôle.

Exemples

L’exemple de code suivant lie un TextBox contrôle à une colonne de table dans un DataSet nommé myDataSet. L’exemple exige 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 Binding création de la chaîne, consultez la dataMember 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, un ArgumentException est levée lorsque le Binding est ajouté à la collection du Control.DataBindings contrôle.

Voir aussi

S’applique à

Binding(String, Object, String, Boolean)

Initialise une nouvelle instance de la classe Binding qui lie la propriété du contrôle indiquée aux données membres spécifiées de la source de données et permet éventuellement l'application de 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é du contrôle à lier.

dataSource: Object

Object représentant 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é fournie par propertyName n'existe pas dans le contrôle.

- ou -

La propriété donnée est 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 une chaîne vide ("").

S’applique à

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

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é du contrôle à lier.

dataSource: Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

Exceptions

ArgumentException

La propriété fournie par propertyName n'existe pas dans le contrôle.

- ou -

La source de données, la donnée membre ou la propriété du contrôle spécifiée sont associées à une autre liaison de 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 Binding création de la chaîne, consultez la dataMember 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)

Initialise une nouvelle instance de la classe Binding qui établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiquée. Active éventuellement la mise en forme, propage les valeurs à la source de données en fonction du paramètre de mise à jour spécifié et affecte à la propriété 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);

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é du contrôle à lier.

dataSource: Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

nullValue: Object

Object devant être appliqué à la propriété du contrôle lié si la valeur de la source de données est DBNull.

Exceptions

ArgumentException

La propriété fournie par propertyName n'existe pas dans le contrôle.

- ou -

La source de données, la donnée membre ou la propriété du contrôle spécifiée sont associées à une autre liaison de 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 Binding création de la chaîne, consultez la dataMember 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)

Initialise une nouvelle instance de la classe Binding qui établit une liaison de la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiqué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 affecte à la propriété la valeur spécifiée lorsque 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é du contrôle à lier.

dataSource: Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

nullValue: Object

Object devant être appliqué à la propriété du contrôle lié si la valeur de la source de données est DBNull.

formatString: String

Un ou plusieurs caractères spécificateurs de format qui indiquent comment une valeur doit s'afficher.

Exceptions

ArgumentException

La propriété fournie par propertyName n'existe pas dans le contrôle.

- ou -

La source de données, la donnée membre ou la propriété du contrôle spécifiée sont associées à une autre liaison de 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 Binding création de la chaîne, consultez la dataMember 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)

Initialise une nouvelle instance de la classe Binding avec la propriété du contrôle spécifiée aux données membres spécifiées de la source de données indiquée. Active éventuellement la mise en forme avec la chaîne de mise en forme 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 mise en forme spécifiée, affecte à la propriété 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é du contrôle à lier.

dataSource: Object

Object représentant 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 valeurs de l'objet DataSourceUpdateMode.

nullValue: Object

Object devant être appliqué à la propriété du contrôle lié si la valeur de la source de données est DBNull.

formatString: String

Un ou plusieurs caractères spécificateurs de format qui indiquent comment une valeur doit s'afficher.

formatInfo: IFormatProvider

Implémentation de IFormatProvider pour substituer le comportement de mise en forme par défaut.

Exceptions

ArgumentException

La propriété fournie par propertyName n'existe pas dans le contrôle.

- ou -

La source de données, la donnée membre ou la propriété du contrôle spécifiée sont associées à une autre liaison de 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 Binding création de la chaîne, consultez la dataMember 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 Constructeurs

Définition

Surcharges

Binding(String, Object, String)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Binding(String, Object, String, Boolean)

Paramètres

Exceptions

S’applique à

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

Paramètres

Exceptions

Remarques

S’applique à

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

Paramètres

Exceptions

Remarques

S’applique à

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

Paramètres

Exceptions

Remarques

S’applique à

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

Paramètres

Exceptions

Remarques

S’applique à

Commentaires

Ressources supplémentaires