Udostępnij za pośrednictwem


Binding Konstruktory

Definicja

Inicjuje nowe wystąpienie klasy Binding.

Przeciążenia

Binding(String, Object, String)

Inicjuje Binding nowe wystąpienie klasy, która łączy wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych.

Binding(String, Object, String, Boolean)

Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych i opcjonalnie umożliwia zastosowanie formatowania.

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie i propagację wartości do źródła danych na podstawie określonego ustawienia aktualizacji.

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie, propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji i ustawia właściwość na określoną wartość DBNull po powrocie ze źródła danych.

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie za pomocą określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; i ustawia właściwość na określoną wartość, gdy DBNull element jest zwracany ze źródła danych.

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

Inicjuje nowe wystąpienie Binding klasy z określoną właściwością kontrolki do określonego elementu członkowskiego danych określonego źródła danych. Opcjonalnie umożliwia formatowanie za pomocą określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; włącza formatowanie za pomocą określonego ciągu formatu; Ustawia właściwość na określoną wartość, gdy DBNull element jest zwracany ze źródła danych, i ustawia określonego dostawcę formatu.

Binding(String, Object, String)

Inicjuje Binding nowe wystąpienie klasy, która łączy wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych.

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)

Parametry

propertyName
String

Nazwa właściwości kontrolki do powiązania.

dataSource
Object

Element Object reprezentujący źródło danych.

dataMember
String

Właściwość lub lista do powiązania.

Wyjątki

propertyName nie jest prawidłową właściwością kontrolki ani pustym ciągiem ("").

Właściwość podana przez propertyName nie istnieje w kontrolce.

Przykłady

Poniższy przykład kodu wiąże kontrolkę TextBox z kolumną tabeli w DataSet nazwie myDataSet. Przykład wymaga zadeklarowania myDataSet w sekcji deklaracji modułu.

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

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

Jeśli próbujesz powiązać z właściwością, która nie istnieje, ArgumentException zostanie zgłoszony po Binding dodaniu elementu do kolekcji kontrolki Control.DataBindings .

Zobacz też

Dotyczy

Binding(String, Object, String, Boolean)

Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych źródła danych i opcjonalnie umożliwia zastosowanie formatowania.

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)

Parametry

propertyName
String

Nazwa właściwości kontrolki do powiązania.

dataSource
Object

Element Object reprezentujący źródło danych.

dataMember
String

Właściwość lub lista do powiązania.

formattingEnabled
Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

Wyjątki

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Podana właściwość jest właściwością tylko do odczytu.

Formatowanie jest wyłączone i propertyName nie jest prawidłową właściwością kontrolki ani pustym ciągiem ("").

Dotyczy

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie i propagację wartości do źródła danych na podstawie określonego ustawienia aktualizacji.

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)

Parametry

propertyName
String

Nazwa właściwości kontrolki do powiązania.

dataSource
Object

Reprezentująca Object źródło danych.

dataMember
String

Właściwość lub lista do powiązania.

formattingEnabled
Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

dataSourceUpdateMode
DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

Wyjątki

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

Dotyczy

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże wskazaną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie, propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji i ustawia właściwość na określoną wartość DBNull po powrocie ze źródła danych.

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)

Parametry

propertyName
String

Nazwa właściwości kontrolki do powiązania.

dataSource
Object

Reprezentująca Object źródło danych.

dataMember
String

Właściwość lub lista do powiązania.

formattingEnabled
Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

dataSourceUpdateMode
DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

nullValue
Object

Właściwość Object , która ma zostać zastosowana do właściwości powiązanej kontrolki, jeśli wartość źródła danych to DBNull.

Wyjątki

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

Dotyczy

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

Inicjuje Binding nowe wystąpienie klasy, która wiąże określoną właściwość kontrolki z określonym elementem członkowskim danych określonego źródła danych. Opcjonalnie umożliwia formatowanie za pomocą określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; i ustawia właściwość na określoną wartość, gdy DBNull element jest zwracany ze źródła danych.

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)

Parametry

propertyName
String

Nazwa właściwości kontrolki do powiązania.

dataSource
Object

Reprezentująca Object źródło danych.

dataMember
String

Właściwość lub lista do powiązania.

formattingEnabled
Boolean

true aby sformatować wyświetlane dane; w przeciwnym razie , false.

dataSourceUpdateMode
DataSourceUpdateMode

Jedna z DataSourceUpdateMode wartości.

nullValue
Object

Właściwość Object , która ma zostać zastosowana do właściwości powiązanej kontrolki, jeśli wartość źródła danych to DBNull.

formatString
String

Co najmniej jeden znak specyfikatora formatu wskazujący sposób wyświetlania wartości.

Wyjątki

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski danych lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Możesz określić wystąpienie dowolnej z następujących klas dla źródła danych:

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

Dotyczy

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

Inicjuje nowe wystąpienie Binding klasy z określoną właściwością kontrolki do określonego elementu członkowskiego danych określonego źródła danych. Opcjonalnie umożliwia formatowanie przy użyciu określonego ciągu formatu; propaguje wartości do źródła danych na podstawie określonego ustawienia aktualizacji; umożliwia formatowanie przy użyciu określonego ciągu formatu; Ustawia właściwość na określoną wartość, gdy DBNull obiekt jest zwracany ze źródła danych i ustawia określonego dostawcę formatu.

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)

Parametry

propertyName
String

Nazwa właściwości kontrolki, która ma być powiązana.

dataSource
Object

Element Object reprezentujący źródło danych.

dataMember
String

Właściwość lub lista, z która ma być powiązana.

formattingEnabled
Boolean

true w celu sformatowania wyświetlanych danych; w przeciwnym razie , false.

dataSourceUpdateMode
DataSourceUpdateMode

DataSourceUpdateMode Jedna z wartości.

nullValue
Object

Właściwość , która ma zostać zastosowana Object do powiązanej kontrolki, jeśli wartość źródła danych to DBNull.

formatString
String

Co najmniej jeden znak specyfikatora formatu wskazujący sposób wyświetlania wartości.

formatInfo
IFormatProvider

Implementacja w celu zastąpienia domyślnego IFormatProvider zachowania formatowania.

Wyjątki

Właściwość podana przez propertyName nie istnieje w kontrolce.

-lub-

Określone źródło danych lub element członkowski lub właściwość kontrolki są skojarzone z innym powiązaniem w kolekcji.

Uwagi

Dla źródła danych można określić wystąpienie dowolnej z następujących klas:

Zobacz klasę, Binding aby uzyskać więcej informacji na temat tworzenia dataMember ciągu.

Po utworzeniu powiązania z właściwością kontrolki nowa Binding funkcja sprawdza zdarzenia uwidocznione przez powiązaną kontrolkę i dołącza do dwóch określonych zdarzeń:

Dotyczy