Condividi tramite


Binding Costruttori

Definizione

Inizializza una nuova istanza della classe Binding.

Overload

Binding(String, Object, String)

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo indicata e il membro dati specificato dell'origine dati.

Binding(String, Object, String, Boolean)

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo indicata e il membro dati specificato dell'origine dati, consentendo inoltre l'applicazione della formattazione, se richiesta.

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

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, consente la formattazione e la propagazione dei valori nell'origine dati in base all'impostazione di aggiornamento specificata.

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

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo e il membro dati specificati dell'origine dati indicata. Se richiesto, abilita la formattazione, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce DBNull.

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

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce un valore DBNull.

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

Inizializza una nuova istanza della classe Binding con proprietà del controllo specificato sul membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata; propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata; abilita la formattazione con la stringa di formato specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce DBNull nonché imposta il provider del formato specificato.

Binding(String, Object, String)

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo indicata e il 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);
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

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

La proprietà specificata da propertyName non esiste nel controllo.

Esempio

L'esempio di codice seguente associa 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:

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

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

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

Vedi anche

Si applica a

Binding(String, Object, String, Boolean)

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo indicata e il membro dati specificato dell'origine dati, consentendo inoltre l'applicazione della formattazione, se richiesta.

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)

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

La proprietà specificata da propertyName non esiste nel controllo.

-oppure-

La proprietà specificata è di sola lettura.

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

Si applica a

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

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, consente la formattazione e la propagazione dei valori nell'origine dati in base all'impostazione di aggiornamento specificata.

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)

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 valori di DataSourceUpdateMode.

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo.

-oppure-

La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.

Commenti

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

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

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

Si applica a

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

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione tra la proprietà del controllo e il membro dati specificati dell'origine dati indicata. Se richiesto, abilita la formattazione, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce DBNull.

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)

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 valori di DataSourceUpdateMode.

nullValue
Object

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

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo.

-oppure-

La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.

Commenti

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

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

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

Si applica a

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

Inizializza una nuova istanza della classe Binding che stabilisce un'associazione semplice tra la proprietà del controllo specificato e il membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata, propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce un valore DBNull.

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)

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 valori di DataSourceUpdateMode.

nullValue
Object

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

formatString
String

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

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo.

-oppure-

La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.

Commenti

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

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

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

Si applica a

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

Inizializza una nuova istanza della classe Binding con proprietà del controllo specificato sul membro dati specificato dell'origine dati specificata. Se richiesto, abilita la formattazione con la stringa di formato specificata; propaga i valori nell'origine dati in base all'impostazione di aggiornamento specificata; abilita la formattazione con la stringa di formato specificata e imposta la proprietà sul valore specificato quando l'origine dati restituisce DBNull nonché imposta il provider del 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);
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 valori di DataSourceUpdateMode.

nullValue
Object

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

Eccezioni

La proprietà specificata da propertyName non esiste nel controllo.

-oppure-

La coppia origine dati o membro dati o la proprietà del controllo specificata è associata a un'altra associazione nell'insieme.

Commenti

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

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:

Si applica a