Binding Oluşturucular

Başvuru

Tanım

Ad Alanı:: System.Windows.Forms

Bütünleştirilmiş Kod:: System.Windows.Forms.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Binding sınıfının yeni bir örneğini başlatır.

Aşırı Yüklemeler

Binding(String, Object, String)	Belirtilen denetim özelliğini veri kaynağının Binding belirtilen veri üyesine basit olarak bağlayan sınıfının yeni bir örneğini başlatır.
Binding(String, Object, String, Boolean)	Belirtilen denetim özelliğini veri kaynağının Binding belirtilen veri üyesine bağlayan ve isteğe bağlı olarak biçimlendirmenin uygulanmasını sağlayan sınıfının yeni bir örneğini başlatır.
Binding(String, Object, String, Boolean, DataSourceUpdateMode)	Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen güncelleştirme ayarına göre biçimlendirmeyi etkinleştirir ve değerleri veri kaynağına yayılım.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object)	Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak biçimlendirmeyi etkinleştirir, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayılır ve veri kaynağından bir DBNull döndürülürken özelliği belirtilen değere ayarlar.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)	Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; belirtilen güncelleştirme ayarına göre değerleri veri kaynağına yayılım; ve veri kaynağından bir DBNull döndürülürken özelliğini belirtilen değere ayarlar.
Binding(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)	Belirtilen veri kaynağının belirtilen veri üyesine Binding belirtilen denetim özelliğiyle sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; belirtilen güncelleştirme ayarına göre değerleri veri kaynağına yayılım; belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; , veri kaynağından bir döndürülürken DBNull özelliğini belirtilen değere ayarlar ve belirtilen biçim sağlayıcısını ayarlar.

Binding(String, Object, String)

Belirtilen denetim özelliğini veri kaynağının Binding belirtilen veri üyesine basit olarak bağlayan sınıfının yeni bir örneğini başlatır.

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)

Parametreler

propertyName: String

Bağlanacak denetim özelliğinin adı.

dataSource: Object

Object Veri kaynağını temsil eden bir.

dataMember: String

Bağlanacak özellik veya liste.

Özel durumlar

Exception

propertyName denetimin geçerli bir özelliği veya boş bir dize ("") değildir.

ArgumentException

tarafından propertyName verilen özellik denetimde yok.

Örnekler

Aşağıdaki kod örneği, bir TextBox denetimi adlı myDataSetbir tablo sütununa DataSet bağlar. Örnek, modülün bildirimler bölümünde bildirmiş myDataSet olmanız gerekir.

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

Açıklamalar

Veri kaynağı için aşağıdaki sınıflardan herhangi birinin örneğini belirtebilirsiniz:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Arabirimi uygulayan IList herhangi bir sınıf
Herhangi bir sınıf

Dizeyi Binding oluşturma hakkında daha fazla bilgi için sınıfına dataMember bakın.

Denetimin özelliğine bağlama oluşturduğunuzda, yeni Binding , ilişkili denetim tarafından kullanıma sunulan olayları inceler ve iki belirli olaya ekler:

Control.Validating
PropertyNameChanged adlı bir olay (örneğin, Control.BackColorChanged)

Var olmayan bir özelliğe bağlamayı denerseniz, denetimin Control.DataBindings koleksiyonuna eklendiğinde Binding bir ArgumentException oluşturulur.

Ayrıca bkz.

Şunlara uygulanır

Binding(String, Object, String, Boolean)

Belirtilen denetim özelliğini veri kaynağının Binding belirtilen veri üyesine bağlayan ve isteğe bağlı olarak biçimlendirmenin uygulanmasını sağlayan sınıfının yeni bir örneğini başlatır.

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)

Parametreler

propertyName: String

Bağlanacak denetim özelliğinin adı.

dataSource: Object

Object Veri kaynağını temsil eden bir.

dataMember: String

Bağlanacak özellik veya liste.

formattingEnabled: Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

Özel durumlar

ArgumentException

tarafından propertyName verilen özellik denetimde yok.

-veya-

Verilen özellik salt okunur bir özelliktir.

Exception

Biçimlendirme devre dışıdır ve propertyName denetimin geçerli bir özelliği veya boş dize ("") değildir.

Şunlara uygulanır

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

Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen güncelleştirme ayarına göre biçimlendirmeyi etkinleştirir ve değerleri veri kaynağına yayılım.

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)

Parametreler

propertyName: String

Bağlanacak denetim özelliğinin adı.

dataSource: Object

Object Veri kaynağını temsil eden bir.

dataMember: String

Bağlanacak özellik veya liste.

formattingEnabled: Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

dataSourceUpdateMode: DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

Özel durumlar

ArgumentException

tarafından propertyName verilen özellik denetimde yok.

-veya-

Belirtilen veri kaynağı veya veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

Veri kaynağı için aşağıdaki sınıflardan herhangi birinin örneğini belirtebilirsiniz:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Arabirimi uygulayan IList herhangi bir sınıf
Herhangi bir sınıf

Dizeyi Binding oluşturma hakkında daha fazla bilgi için sınıfına dataMember bakın.

Denetimin özelliğine bağlama oluşturduğunuzda, yeni Binding , ilişkili denetim tarafından kullanıma sunulan olayları inceler ve iki belirli olaya ekler:

Control.Validating.
PropertyNameChanged adlı bir olay (örneğin, Control.BackColorChanged)

Şunlara uygulanır

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

Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak biçimlendirmeyi etkinleştirir, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayılır ve veri kaynağından bir DBNull döndürülürken özelliği belirtilen değere ayarlar.

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)

Parametreler

propertyName: String

Bağlanacak denetim özelliğinin adı.

dataSource: Object

Object Veri kaynağını temsil eden bir.

dataMember: String

Bağlanacak özellik veya liste.

formattingEnabled: Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

dataSourceUpdateMode: DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

nullValue: Object

Object Veri kaynağı değeri ise, ilişkili denetim özelliğine uygulanacak olan değeridirDBNull.

Özel durumlar

ArgumentException

tarafından propertyName verilen özellik denetimde yok.

-veya-

Belirtilen veri kaynağı veya veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

Veri kaynağı için aşağıdaki sınıflardan herhangi birinin örneğini belirtebilirsiniz:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Arabirimi uygulayan IList herhangi bir sınıf
Herhangi bir sınıf

Dizeyi Binding oluşturma hakkında daha fazla bilgi için sınıfına dataMember bakın.

Denetimin özelliğine bağlama oluşturduğunuzda, yeni Binding , ilişkili denetim tarafından kullanıma sunulan olayları inceler ve iki belirli olaya ekler:

Control.Validating
PropertyNameChanged adlı bir olay (örneğin, Control.BackColorChanged)

Şunlara uygulanır

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

Belirtilen denetim özelliğini belirtilen veri kaynağının Binding belirtilen veri üyesine bağlayan sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; belirtilen güncelleştirme ayarına göre değerleri veri kaynağına yayılım; ve veri kaynağından bir DBNull döndürülürken özelliğini belirtilen değere ayarlar.

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)

Parametreler

propertyName: String

Bağlanacak denetim özelliğinin adı.

dataSource: Object

Object Veri kaynağını temsil eden bir.

dataMember: String

Bağlanacak özellik veya liste.

formattingEnabled: Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

dataSourceUpdateMode: DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

nullValue: Object

Object Veri kaynağı değeri ise, ilişkili denetim özelliğine uygulanacak olan değeridirDBNull.

formatString: String

Bir değerin nasıl görüntüleneceğini gösteren bir veya daha fazla biçim belirtici karakteri.

Özel durumlar

ArgumentException

tarafından propertyName verilen özellik denetimde yok.

-veya-

Belirtilen veri kaynağı veya veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

Veri kaynağı için aşağıdaki sınıflardan herhangi birinin örneğini belirtebilirsiniz:

DataSet
DataTable
DataView
DataViewManager
BindingSource
Arabirimi uygulayan IList herhangi bir sınıf
Herhangi bir sınıf

Dizeyi Binding oluşturma hakkında daha fazla bilgi için sınıfına dataMember bakın.

Denetimin özelliğine bağlama oluşturduğunuzda, yeni Binding , ilişkili denetim tarafından kullanıma sunulan olayları inceler ve iki belirli olaya ekler:

Control.Validating
PropertyNameChanged adlı bir olay (örneğin, Control.BackColorChanged)

Şunlara uygulanır

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

Belirtilen veri kaynağının belirtilen veri üyesine Binding belirtilen denetim özelliğiyle sınıfının yeni bir örneğini başlatır. İsteğe bağlı olarak, belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; belirtilen güncelleştirme ayarına göre değerleri veri kaynağına yayılım; belirtilen biçim dizesiyle biçimlendirmeyi etkinleştirir; , veri kaynağından bir döndürülürken DBNull özelliğini belirtilen değere ayarlar ve belirtilen biçim sağlayıcısını ayarlar.

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)

Parametreler

propertyName: String

Bağlanacak denetim özelliğinin adı.

dataSource: Object

Object Veri kaynağını temsil eden.

dataMember: String

Bağlanacak özellik veya liste.

formattingEnabled: Boolean

true görüntülenen verileri biçimlendirmek için; aksi takdirde , false.

dataSourceUpdateMode: DataSourceUpdateMode

Değerlerden DataSourceUpdateMode biri.

nullValue: Object

Object Veri kaynağı değeri ise, ilişkili denetim özelliğine uygulanacak olan DBNull.

formatString: String

Bir değerin nasıl görüntüleneceğini gösteren bir veya daha fazla biçim tanımlayıcı karakteri.

formatInfo: IFormatProvider

Varsayılan biçimlendirme davranışını geçersiz kılmak için uygulaması IFormatProvider .

Özel durumlar

ArgumentException

tarafından propertyName verilen özellik denetimde yok.

-veya-

Belirtilen veri kaynağı veya veri üyesi ya da denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.

Açıklamalar

Veri kaynağı için aşağıdaki sınıflardan herhangi birinin örneğini belirtebilirsiniz:

DataSet
DataTable
DataView
DataViewManager
BindingSource
arabirimini IList uygulayan herhangi bir sınıf
Herhangi bir sınıf

Dize oluşturma Binding hakkında daha fazla bilgi için sınıfına dataMember bakın.

Bir denetimin özelliğine bağlama oluşturduğunuzda, yeni Binding sınır denetimi tarafından kullanıma sunulan olayları inceler ve iki belirli olaya ekler:

Control.Validating
PropertyNameChanged adlı bir olay (örneğin, Control.BackColorChanged)

Şunlara uygulanır

Binding Oluşturucular

Tanım

Aşırı Yüklemeler

Binding(String, Object, String)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Binding(String, Object, String, Boolean)

Parametreler

Özel durumlar

Şunlara uygulanır

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

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

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

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

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

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

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

Parametreler

Özel durumlar

Açıklamalar

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar