Partager via


Binding Constructeurs

Définition

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

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

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 :

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 :

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

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

- ou -

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

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)

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é.

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

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 :

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 :

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

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 :

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 :

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

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 :

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 :

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

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 :

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 :

S’applique à