ControlBindingsCollection.Add Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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 .