Binding Costruttori

Definizione

Spazio dei nomi:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Inizializza una nuova istanza della classe Binding.

Overload

Nome	Descrizione
Binding(String, Object, String)	Inizializza una nuova istanza della Binding classe che associa in modo semplice la proprietà del controllo indicato al membro dati specificato dell'origine dati.
Binding(String, Object, String, Boolean)	Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo indicato al membro dati specificato dell'origine dati e, facoltativamente, consente l'applicazione della formattazione.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione e propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo indicato al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione, propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione con la stringa di formato specificata; propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata; e imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Inizializza una nuova istanza della Binding classe con la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione con la stringa di formato specificata; propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata; abilita la formattazione con la stringa di formato specificata; imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati e imposta il provider di formato specificato.

Binding(String, Object, String)

Inizializza una nuova istanza della Binding classe che associa in modo semplice la proprietà del controllo indicato al membro dati specificato dell'origine dati.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::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)

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.

Eccezioni

Exception

propertyName non è né una proprietà valida di un controllo né una stringa vuota ("").

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo .

Esempio

Nell'esempio di codice seguente viene associato un TextBox controllo a una colonna di tabella in un DataSet oggetto denominato myDataSet. L'esempio richiede che sia stato dichiarato myDataSet nella sezione dichiarazioni del modulo.

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

Commenti

È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe

Per altre informazioni sulla creazione della dataMember stringa, vedere la Binding classe .

Quando si crea un'associazione alla proprietà di un controllo, il nuovo Binding controlla gli eventi esposti dal controllo associato e si associa a due eventi specifici:

Control.Validating
Evento denominato PropertyNameChanged (ad esempio, Control.BackColorChanged)

Se si tenta di eseguire l'associazione a una proprietà che non esiste, verrà generata un'eccezione ArgumentException quando Binding l'oggetto viene aggiunto all'insieme del Control.DataBindings controllo.

Vedi anche

Si applica a

Binding(String, Object, String, Boolean)

Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo indicato al membro dati specificato dell'origine dati e, facoltativamente, consente l'applicazione della formattazione.

public:
 Binding(System::String ^ propertyName, System::Object ^ dataSource, System::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)

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.

Eccezioni

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo .

oppure

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

Exception

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

Si applica a

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);

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)

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno dei DataSourceUpdateMode valori.

Eccezioni

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo .

oppure

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

Commenti

È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe

Per altre informazioni sulla creazione della dataMember stringa, vedere la Binding classe .

Quando si crea un'associazione alla proprietà di un controllo, il nuovo Binding controlla gli eventi esposti dal controllo associato e si associa a due eventi specifici:

Control.Validating.
Evento denominato PropertyNameChanged (ad esempio, Control.BackColorChanged)

Si applica a

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

Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo indicato al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione, propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati.

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);

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)

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno dei DataSourceUpdateMode valori.

nullValue: Object

Oggetto Object da applicare alla proprietà del controllo associato se il valore dell'origine dati è DBNull.

Eccezioni

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo .

oppure

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

Commenti

È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe

Per altre informazioni sulla creazione della dataMember stringa, vedere la Binding classe .

Quando si crea un'associazione alla proprietà di un controllo, il nuovo Binding controlla gli eventi esposti dal controllo associato e si associa a due eventi specifici:

Control.Validating
Evento denominato PropertyNameChanged (ad esempio, Control.BackColorChanged)

Si applica a

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

Inizializza una nuova istanza della Binding classe che associa la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione con la stringa di formato specificata; propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata; e imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati.

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);

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)

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno dei DataSourceUpdateMode valori.

nullValue: Object

Oggetto Object da applicare alla proprietà del controllo associato se il valore dell'origine dati è DBNull.

formatString: String

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

Eccezioni

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo .

oppure

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

Commenti

È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe

Per altre informazioni sulla creazione della dataMember stringa, vedere la Binding classe .

Quando si crea un'associazione alla proprietà di un controllo, il nuovo Binding controlla gli eventi esposti dal controllo associato e si associa a due eventi specifici:

Control.Validating
Evento denominato PropertyNameChanged (ad esempio, Control.BackColorChanged)

Si applica a

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

Inizializza una nuova istanza della Binding classe con la proprietà del controllo specificata al membro dati specificato dell'origine dati specificata. Facoltativamente, abilita la formattazione con la stringa di formato specificata; propaga i valori all'origine dati in base all'impostazione di aggiornamento specificata; abilita la formattazione con la stringa di formato specificata; imposta la proprietà sul valore specificato quando un DBNull oggetto viene restituito dall'origine dati e imposta il provider di formato specificato.

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);

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)

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.

dataSourceUpdateMode: DataSourceUpdateMode

Uno dei DataSourceUpdateMode valori.

nullValue: Object

Oggetto Object da applicare alla proprietà del controllo associato se il valore dell'origine dati è 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.

Eccezioni

ArgumentException

La proprietà specificata da propertyName non esiste nel controllo .

oppure

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

Commenti

È possibile specificare un'istanza di una delle classi seguenti per l'origine dati:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Qualsiasi classe che implementa l'interfaccia IList
Qualsiasi classe

Per altre informazioni sulla creazione della dataMember stringa, vedere la Binding classe .

Quando si crea un'associazione alla proprietà di un controllo, il nuovo Binding controlla gli eventi esposti dal controllo associato e si associa a due eventi specifici:

Control.Validating
Evento denominato PropertyNameChanged (ad esempio, Control.BackColorChanged)

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?