ControlBindingsCollection.Add Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Aggiunge un oggetto Binding alla raccolta.

Overload

Add(Binding)

Aggiunge l'oggetto Binding specificato alla raccolta.
Add(String, Object, String)

Crea un Binding usando il nome della proprietà, l'origine dati e il membro dati del controllo specificato e lo aggiunge alla raccolta.
Add(String, Object, String, Boolean)

Crea un'associazione con il nome della proprietà del controllo, l'origine dati, il membro dati e le informazioni sull'abilitazione della formattazione specificati, infine aggiunge tale associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode)

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate e aggiunge l'associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull e aggiunge l'associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione con la stringa di formato specificata, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull e aggiunge l'associazione alla raccolta.
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione con la stringa di formato specificata, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull, imposta il provider di formato specificato e aggiunge l'associazione alla raccolta.

Add(Binding)

Aggiunge l'oggetto Binding specificato alla raccolta.

public:
 void Add(System::Windows::Forms::Binding ^ binding);
public void Add (System.Windows.Forms.Binding binding);
override this.Add : System.Windows.Forms.Binding -> unit
Public Sub Add (binding As Binding)

Parametri

binding
Binding

Oggetto Binding da aggiungere.

Eccezioni

ArgumentNullException

binding è Null.

ArgumentException

La proprietà del controllo dispone già di un'associazione a dati.

-oppure-

L'oggetto Binding non specifica una colonna valida della proprietà DataSource.

Esempio

Nell'esempio di codice seguente viene creata un'istanza Binding di e viene utilizzato il Add metodo per aggiungere l'istanza a ControlBindingsCollection di un TextBox controllo .

protected:
   void BindControls()
   {
      /* Create a new Binding using the DataSet and a 
         navigation path(TableName.RelationName.ColumnName).
         Add event delegates for the Parse and Format events to 
         the Binding object, and add the object to the third 
         TextBox control's BindingsCollection. The delegates 
         must be added before adding the Binding to the 
         collection; otherwise, no formatting occurs until 
         the Current object of the BindingManagerBase for 
         the data source changes. */
      Binding^ b = gcnew Binding(
         "Text",ds,"customers.custToOrders.OrderAmount" );
      b->Parse += gcnew ConvertEventHandler(
         this, &Form1::CurrencyStringToDecimal );
      b->Format += gcnew ConvertEventHandler(
         this, &Form1::DecimalToCurrencyString );
      textBox1->DataBindings->Add( b );
   }

protected void BindControls()
{
   /* Create a new Binding using the DataSet and a 
   navigation path(TableName.RelationName.ColumnName).
   Add event delegates for the Parse and Format events to 
   the Binding object, and add the object to the third 
   TextBox control's BindingsCollection. The delegates 
   must be added before adding the Binding to the 
   collection; otherwise, no formatting occurs until 
   the Current object of the BindingManagerBase for 
   the data source changes. */
   Binding b = new Binding
   ("Text", ds, "customers.custToOrders.OrderAmount");
   b.Parse+=new ConvertEventHandler(CurrencyStringToDecimal);
   b.Format+=new ConvertEventHandler(DecimalToCurrencyString);
   textBox1.DataBindings.Add(b);
}

Protected Sub BindControls()
    ' Create a new Binding using the DataSet and a 
    ' navigation path(TableName.RelationName.ColumnName).
    ' Add event delegates for the Parse and Format events to 
    ' the Binding object, and add the object to the third 
    ' TextBox control's BindingsCollection. The delegates 
    ' must be added before adding the Binding to the 
    ' collection; otherwise, no formatting occurs until 
    ' the Current object of the BindingManagerBase for 
    ' the data source changes. 
    Dim b As New Binding("Text", ds, "customers.custToOrders.OrderAmount")
    AddHandler b.Parse, AddressOf CurrencyStringToDecimal
    AddHandler b.Format, AddressOf DecimalToCurrencyString
    textBox1.DataBindings.Add(b)
End Sub

Commenti

La DataSourceUpdateMode proprietà dell'oggetto Binding creato da questo overload del Add metodo viene impostata sul valore della DefaultDataSourceUpdateMode proprietà .

L'evento CollectionChanged si verifica al termine della modifica.

Si applica a

Add(String, Object, String)

Crea un Binding usando il nome della proprietà, l'origine dati e il membro dati del controllo specificato e lo aggiunge alla raccolta.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember);
override this.Add : string * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String) As Binding

Parametri

propertyName
String

Nome della proprietà del controllo da associare.

dataSource
Object

Oggetto Object che rappresenta l'origine dati.

dataMember
String

Proprietà o elenco a cui eseguire l'associazione.

Restituisce

Binding

Oggetto Binding appena creato.

Eccezioni

ArgumentNullException

L'elemento binding è null.

Exception

propertyName dispone già di un'associazione a dati.

-oppure-

Il parametro dataMember non specifica un membro valido di dataSource.

Esempio

Nell'esempio di codice seguente viene utilizzato il Add metodo per aggiungere tre Binding oggetti all'oggetto ControlBindingsCollection di un TextBox controllo . È possibile accedere a ControlBindingsCollection tramite la proprietà DataBindings della classe Control.

private:
   void BindTextBoxProperties()
   {
      // Clear the collection before adding new Binding objects.
      textBox1->DataBindings->Clear();

      // Create a DataTable containing Color objects.
      DataTable^ t = MakeTable();

      /* Bind the Text, BackColor, and ForeColor properties
         to columns in the DataTable. */
      textBox1->DataBindings->Add( "Text", t, "Text" );
      textBox1->DataBindings->Add( "BackColor", t, "BackColor" );
      textBox1->DataBindings->Add( "ForeColor", t, "ForeColor" );
   }

   DataTable^ MakeTable()
   {
      /* Create a DataTable with three columns.
         Two of the columns contain Color objects. */
      DataTable^ t = gcnew DataTable( "Control" );
      t->Columns->Add( "BackColor", Color::typeid );
      t->Columns->Add( "ForeColor", Color::typeid );
      t->Columns->Add( "Text" );

      // Add three rows to the table.
      DataRow^ r;
      r = t->NewRow();
      r[ "BackColor" ] = Color::Blue;
      r[ "ForeColor" ] = Color::Yellow;
      r[ "Text" ] = "Yellow on Blue";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::White;
      r[ "ForeColor" ] = Color::Green;
      r[ "Text" ] = "Green on white";
      t->Rows->Add( r );
      r = t->NewRow();
      r[ "BackColor" ] = Color::Orange;
      r[ "ForeColor" ] = Color::Black;
      r[ "Text" ] = "Black on Orange";
      t->Rows->Add( r );
      return t;
   }

private void BindTextBoxProperties()
{
   // Clear the collection before adding new Binding objects.
   textBox1.DataBindings.Clear();

   // Create a DataTable containing Color objects.
   DataTable t = MakeTable();

   /* Bind the Text, BackColor, and ForeColor properties
   to columns in the DataTable. */
   textBox1.DataBindings.Add("Text", t, "Text");
   textBox1.DataBindings.Add("BackColor", t, "BackColor");
   textBox1.DataBindings.Add("ForeColor", t, "ForeColor");
}

private DataTable MakeTable()
{
   /* Create a DataTable with three columns.
   Two of the columns contain Color objects. */

   DataTable t = new DataTable("Control");
   t.Columns.Add("BackColor", typeof(Color));
   t.Columns.Add("ForeColor", typeof(Color));
   t.Columns.Add("Text");

   // Add three rows to the table.
   DataRow r;

   r = t.NewRow();
   r["BackColor"] = Color.Blue;
   r["ForeColor"] = Color.Yellow;
   r["Text"] = "Yellow on Blue";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.White;
   r["ForeColor"] = Color.Green;
   r["Text"] = "Green on white";
   t.Rows.Add(r);

   r = t.NewRow();
   r["BackColor"] = Color.Orange;
   r["ForeColor"] = Color.Black;
   r["Text"] = "Black on Orange";
   t.Rows.Add(r);

   return t;
}

Private Sub BindTextBoxProperties()
    ' Clear the collection before adding new Binding objects.
    textBox1.DataBindings.Clear()
    
    ' Create a DataTable containing Color objects.
    Dim t As DataTable = MakeTable()
    
    ' Bind the Text, BackColor, and ForeColor properties
    ' to columns in the DataTable. 
    textBox1.DataBindings.Add("Text", t, "Text")
    textBox1.DataBindings.Add("BackColor", t, "BackColor")
    textBox1.DataBindings.Add("ForeColor", t, "ForeColor")
End Sub    

Private Function MakeTable() As DataTable
    ' Create a DataTable with three columns.
    ' Two of the columns contain Color objects. 
    
    Dim t As New DataTable("Control")
    t.Columns.Add("BackColor", GetType(Color))
    t.Columns.Add("ForeColor", GetType(Color))
    t.Columns.Add("Text")
    
    ' Add three rows to the table.
    Dim r As DataRow
    
    r = t.NewRow()
    r("BackColor") = Color.Blue
    r("ForeColor") = Color.Yellow
    r("Text") = "Yellow on Blue"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.White
    r("ForeColor") = Color.Green
    r("Text") = "Green on white"
    t.Rows.Add(r)
    
    r = t.NewRow()
    r("BackColor") = Color.Orange
    r("ForeColor") = Color.Black
    r("Text") = "Black on Orange"
    t.Rows.Add(r)
    
    Return t
End Function

Commenti

La DataSourceUpdateMode proprietà dell'oggetto Binding creato da questo overload del Add metodo viene impostata sul valore della DefaultDataSourceUpdateMode proprietà .

L'aggiunta di un Binding fa sì che si verifichi l'evento CollectionChanged .

Si applica a

Add(String, Object, String, Boolean)

Crea un'associazione con il nome della proprietà del controllo, l'origine dati, il membro dati e le informazioni sull'abilitazione della formattazione specificati, infine aggiunge tale associazione alla raccolta.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled);
override this.Add : string * obj * string * bool -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean) As Binding

Parametri

propertyName
String

Nome della proprietà del controllo da associare.

dataSource
Object

Oggetto Object che rappresenta l'origine dati.

dataMember
String

Proprietà o elenco a cui eseguire l'associazione.

formattingEnabled
Boolean

true per formattare i dati visualizzati; in caso contrario, false.

Restituisce

Binding

Oggetto Binding appena creato.

Eccezioni

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo.

-oppure-

La proprietà specificata è di sola lettura.

Exception

Se la formattazione è disabilitata e propertyName non è né una proprietà valida di un controllo né una stringa vuota ("").

Si applica a

Add(String, Object, String, Boolean, DataSourceUpdateMode)

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate e aggiunge l'associazione alla raccolta.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode) As Binding

Parametri

propertyName
String

Nome della proprietà del controllo da associare.

dataSource
Object

Oggetto Object che rappresenta l'origine dati.

dataMember
String

Proprietà o elenco a cui eseguire l'associazione.

formattingEnabled
Boolean

true per formattare i dati visualizzati; in caso contrario, false.

updateMode
DataSourceUpdateMode

Uno dei valori di DataSourceUpdateMode.

Restituisce

Binding

Oggetto Binding appena creato.

Eccezioni

ArgumentException

La proprietà data dall'oggetto propertyName non esiste sul controllo o è di sola lettura.

-oppure-

Il membro dati specificato non esiste sull'origine dati.

-oppure-

L'origine dati, il membro dati o la proprietà del controllo specificati sono associati a un'altra associazione presente nell'insieme.

Commenti

La chiamata al Add metodo genera l'evento CollectionChanged .

Si applica a

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull e aggiunge l'associazione alla raccolta.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object) As Binding

Parametri

propertyName
String

Nome della proprietà del controllo da associare.

dataSource
Object

Oggetto Object che rappresenta l'origine dati.

dataMember
String

Proprietà o elenco a cui eseguire l'associazione.

formattingEnabled
Boolean

true per formattare i dati visualizzati; in caso contrario, false.

updateMode
DataSourceUpdateMode

Uno dei valori di DataSourceUpdateMode.

nullValue
Object

Quando questo valore è l'origine dati, la proprietà associata è impostata su DBNull.

Restituisce

Binding

Oggetto Binding appena creato.

Eccezioni

ArgumentException

La proprietà data dall'oggetto propertyName non esiste sul controllo o è di sola lettura.

-oppure-

Il membro dati specificato non esiste sull'origine dati.

-oppure-

L'origine dati, il membro dati o la proprietà del controllo specificati sono associati a un'altra associazione presente nell'insieme.

Commenti

La chiamata al Add metodo genera l'evento CollectionChanged .

Si applica a

Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione con la stringa di formato specificata, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull e aggiunge l'associazione alla raccolta.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String) As Binding

Parametri

propertyName
String

Nome della proprietà del controllo da associare.

dataSource
Object

Oggetto Object che rappresenta l'origine dati.

dataMember
String

Proprietà o elenco a cui eseguire l'associazione.

formattingEnabled
Boolean

true per formattare i dati visualizzati; in caso contrario, false.

updateMode
DataSourceUpdateMode

Uno dei valori di DataSourceUpdateMode.

nullValue
Object

Quando questo valore è l'origine dati, la proprietà associata è impostata su DBNull.

formatString
String

Uno o più caratteri identificatori di formato che indicano il modo in cui deve essere visualizzato un valore.

Restituisce

Binding

Oggetto Binding appena creato.

Eccezioni

ArgumentException

La proprietà data dall'oggetto propertyName non esiste sul controllo o è di sola lettura.

-oppure-

Il membro dati specificato non esiste sull'origine dati.

-oppure-

L'origine dati, il membro dati o la proprietà del controllo specificati sono associati a un'altra associazione presente nell'insieme.

Commenti

La chiamata al Add metodo genera l'evento CollectionChanged .

Si applica a

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

Crea un'associazione tra la proprietà del controllo specificata e il membro dati indicato dell'origine dati specificata, facoltativamente abilita la formattazione con la stringa di formato specificata, propaga i valori all'origine dati in base alle impostazioni di aggiornamento specificate, imposta la proprietà sul valore specificato quando l'origine dati restituisce l'oggetto DBNull, imposta il provider di formato specificato e aggiunge l'associazione alla raccolta.

public:
 System::Windows::Forms::Binding ^ Add(System::String ^ propertyName, System::Object ^ dataSource, System::String ^ dataMember, bool formattingEnabled, System::Windows::Forms::DataSourceUpdateMode updateMode, System::Object ^ nullValue, System::String ^ formatString, IFormatProvider ^ formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object nullValue, string formatString, IFormatProvider formatInfo);
public System.Windows.Forms.Binding Add (string propertyName, object dataSource, string? dataMember, bool formattingEnabled, System.Windows.Forms.DataSourceUpdateMode updateMode, object? nullValue, string formatString, IFormatProvider? formatInfo);
override this.Add : string * obj * string * bool * System.Windows.Forms.DataSourceUpdateMode * obj * string * IFormatProvider -> System.Windows.Forms.Binding
Public Function Add (propertyName As String, dataSource As Object, dataMember As String, formattingEnabled As Boolean, updateMode As DataSourceUpdateMode, nullValue As Object, formatString As String, formatInfo As IFormatProvider) As Binding

Parametri

propertyName
String

Nome della proprietà del controllo da associare.

dataSource
Object

Oggetto Object che rappresenta l'origine dati.

dataMember
String

Proprietà o elenco a cui eseguire l'associazione.

formattingEnabled
Boolean

true per formattare i dati visualizzati; in caso contrario, false.

updateMode
DataSourceUpdateMode

Uno dei valori di DataSourceUpdateMode.

nullValue
Object

Quando questo valore è l'origine dati, la proprietà associata è impostata su DBNull.

formatString
String

Uno o più caratteri identificatori di formato che indicano il modo in cui deve essere visualizzato un valore.

formatInfo
IFormatProvider

Implementazione di IFormatProvider per eseguire l'override del comportamento predefinito della formattazione.

Restituisce

Binding

Oggetto Binding appena creato.

Eccezioni

ArgumentException

La proprietà data dall'oggetto propertyName non esiste sul controllo o è di sola lettura.

-oppure-

Il membro dati specificato non esiste sull'origine dati.

-oppure-

L'origine dati, il membro dati o la proprietà del controllo specificati sono associati a un'altra associazione presente nell'insieme.

Commenti

La chiamata al metodo genera l'evento AddCollectionChanged .

Si applica a