Condividi tramite


ControlBindingsCollection.Add Metodo

Definizione

Aggiunge un oggetto Binding all'insieme.

Overload

Nome Descrizione
Add(Binding)

Aggiunge l'oggetto specificato Binding all'insieme.

Add(String, Object, String)

Crea un Binding oggetto utilizzando il nome della proprietà del controllo, l'origine dati e il membro dati specificati 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 e aggiunge l'associazione alla raccolta.

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

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata e aggiungendo l'associazione alla raccolta.

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

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata, impostando la proprietà sul valore specificato quando DBNull viene restituito dall'origine dati e aggiungendo l'associazione alla raccolta.

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

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione con la stringa di formato specificata, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata, impostando la proprietà sul valore specificato quando DBNull viene restituito dall'origine dati e aggiungendo l'associazione alla raccolta.

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

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione con la stringa di formato specificata, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata, impostando la proprietà sul valore specificato quando DBNull viene restituito dall'origine dati, impostando il provider di formato specificato, e aggiungendo l'associazione alla raccolta.

Add(Binding)

Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs

Aggiunge l'oggetto specificato Binding all'insieme.

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

è binding null.

La proprietà del controllo è già associata a dati.

oppure

Non Binding specifica una colonna valida dell'oggetto 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)

Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs

Crea un Binding oggetto utilizzando il nome della proprietà del controllo, l'origine dati e il membro dati specificati 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

Oggetto appena creato Binding.

Eccezioni

Il binding è null.

è propertyName già associato a dati.

oppure

dataMember non specifica un membro valido dell'oggetto dataSource.

Esempio

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

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 oggetto fa sì che si verifichi l'evento CollectionChanged .

Si applica a

Add(String, Object, String, Boolean)

Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs

Crea un'associazione con il nome della proprietà del controllo, l'origine dati, il membro dati e le informazioni sull'abilitazione della formattazione e aggiunge l'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

Oggetto appena creato Binding.

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo .

oppure

La proprietà specificata è una proprietà di sola lettura.

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

Si applica a

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

Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata e aggiungendo 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 DataSourceUpdateMode valori.

Restituisce

Oggetto appena creato Binding.

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo o è di sola lettura.

oppure

Il membro dati specificato non esiste nell'origine dati.

oppure

L'origine dati, il membro dati o la proprietà del controllo specificata sono associati a un'altra associazione nella raccolta.

Commenti

La chiamata al Add metodo genera l'evento CollectionChanged .

Si applica a

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

Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata, impostando la proprietà sul valore specificato quando DBNull viene restituito dall'origine dati e aggiungendo 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 DataSourceUpdateMode valori.

nullValue
Object

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

Restituisce

Oggetto appena creato Binding.

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo o è di sola lettura.

oppure

Il membro dati specificato non esiste nell'origine dati.

oppure

L'origine dati, il membro dati o la proprietà del controllo specificata sono associati a un'altra associazione nella raccolta.

Commenti

La chiamata al Add metodo genera l'evento CollectionChanged .

Si applica a

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

Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione con la stringa di formato specificata, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata, impostando la proprietà sul valore specificato quando DBNull viene restituito dall'origine dati e aggiungendo 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 DataSourceUpdateMode valori.

nullValue
Object

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

formatString
String

Uno o più caratteri dell'identificatore di formato che indicano la modalità di visualizzazione di un valore.

Restituisce

Oggetto appena creato Binding.

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo o è di sola lettura.

oppure

Il membro dati specificato non esiste nell'origine dati.

oppure

L'origine dati, il membro dati o la proprietà del controllo specificata sono associati a un'altra associazione nella raccolta.

Commenti

La chiamata al Add metodo genera l'evento CollectionChanged .

Si applica a

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

Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs
Origine:
ControlBindingsCollection.cs

Crea un'associazione che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata, abilitando facoltativamente la formattazione con la stringa di formato specificata, propagando i valori all'origine dati in base all'impostazione di aggiornamento specificata, impostando la proprietà sul valore specificato quando DBNull viene restituito dall'origine dati, impostando il provider di formato specificato, e aggiungendo 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 DataSourceUpdateMode valori.

nullValue
Object

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

formatString
String

Uno o più caratteri dell'identificatore di formato che indicano la modalità di visualizzazione di un valore.

formatInfo
IFormatProvider

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

Restituisce

Oggetto appena creato Binding.

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo o è di sola lettura.

oppure

Il membro dati specificato non esiste nell'origine dati.

oppure

L'origine dati, il membro dati o la proprietà del controllo specificata sono associati a un'altra associazione nella raccolta.

Commenti

La chiamata al Add metodo genera l'evento CollectionChanged .

Si applica a