ControlBindingsCollection.Add Yöntem
Tanım
Ö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.
Koleksiyona bir Binding ekler.
Aşırı Yüklemeler
Add(Binding) |
Belirtilen Binding öğesini koleksiyona ekler. |
Add(String, Object, String) |
Belirtilen denetim özelliği adını, veri kaynağını ve veri üyesini kullanarak bir Binding oluşturur ve bunu koleksiyona ekler. |
Add(String, Object, String, Boolean) |
Belirtilen denetim özelliği adına, veri kaynağına, veri üyesine ve biçimlendirmenin etkinleştirilip etkinleştirilmediğine ilişkin bilgilere sahip bir bağlama oluşturur ve bağlamayı koleksiyona ekler. |
Add(String, Object, String, Boolean, DataSourceUpdateMode) |
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur. |
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object) |
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur. |
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String) |
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur. |
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider) |
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan, belirtilen biçim sağlayıcısını ayarlayan bir bağlama oluşturur. ve bağlamayı koleksiyona ekler. |
Add(Binding)
Belirtilen Binding öğesini koleksiyona ekler.
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)
Parametreler
Özel durumlar
binding
null değeridir.
Örnekler
Aşağıdaki kod örneği bir Binding örnek oluşturur ve bir denetimin örneğine eklemek için ControlBindingsCollectionTextBox yöntemini kullanırAdd.
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
Açıklamalar
DataSourceUpdateMode yönteminin Binding bu aşırı yüklemesi tarafından oluşturulan özelliğinin Add özelliği, özelliğinin DefaultDataSourceUpdateMode değerine ayarlanır.
Değişiklik CollectionChanged tamamlandığında olay gerçekleşir.
Şunlara uygulanır
Add(String, Object, String)
Belirtilen denetim özelliği adını, veri kaynağını ve veri üyesini kullanarak bir Binding oluşturur ve bunu koleksiyona ekler.
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
Parametreler
- propertyName
- String
Bağlanacak denetim özelliğinin adı.
- dataMember
- String
Bağlanacak özellik veya liste.
Döndürülenler
Yeni oluşturulan Binding.
Özel durumlar
şeklindedir binding
null
.
propertyName
zaten veriye bağlıdır.
-veya-
geçerli dataMember
bir üyesini dataSource
belirtmez.
Örnekler
Aşağıdaki kod örneği, bir denetimin Add öğesine üç Binding nesne eklemek için ControlBindingsCollection yöntemini TextBox kullanır. ControlBindingsCollection öğesine sınıfının özelliği Control aracılığıyla DataBindings erişilir.
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
Açıklamalar
DataSourceUpdateMode yönteminin Binding bu aşırı yüklemesi tarafından oluşturulan özelliğinin Add özelliği, özelliğinin DefaultDataSourceUpdateMode değerine ayarlanır.
Ekleme Binding , olayın gerçekleşmesine neden olur CollectionChanged .
Şunlara uygulanır
Add(String, Object, String, Boolean)
Belirtilen denetim özelliği adına, veri kaynağına, veri üyesine ve biçimlendirmenin etkinleştirilip etkinleştirilmediğine ilişkin bilgilere sahip bir bağlama oluşturur ve bağlamayı koleksiyona ekler.
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
Parametreler
- propertyName
- String
Bağlanacak denetim özelliğinin adı.
- dataMember
- String
Bağlanacak özellik veya liste.
- formattingEnabled
- Boolean
true
görüntülenen verileri biçimlendirmek için; aksi takdirde , false
.
Döndürülenler
Yeni oluşturulan Binding.
Özel durumlar
tarafından propertyName
verilen özellik denetimde yok.
-veya-
Verilen özellik salt okunur bir özelliktir.
Biçimlendirme devre dışıysa ve denetimin propertyName
geçerli bir özelliği değilse veya boş bir dizeyse ("").
Şunlara uygulanır
Add(String, Object, String, Boolean, DataSourceUpdateMode)
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.
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
Parametreler
- propertyName
- String
Bağlanacak denetim özelliğinin adı.
- dataMember
- String
Bağlanacak özellik veya liste.
- formattingEnabled
- Boolean
true
görüntülenen verileri biçimlendirmek için; aksi takdirde , false
.
- updateMode
- DataSourceUpdateMode
Değerlerden DataSourceUpdateMode biri.
Döndürülenler
Yeni oluşturulan Binding.
Özel durumlar
tarafından propertyName
verilen özellik denetimde yok veya salt okunur.
-veya-
Belirtilen veri üyesi veri kaynağında yok.
-veya-
Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.
Açıklamalar
yöntemini çağırmak Add olayı tetikler CollectionChanged .
Şunlara uygulanır
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object)
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.
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
Parametreler
- propertyName
- String
Bağlanacak denetim özelliğinin adı.
- dataMember
- String
Bağlanacak özellik veya liste.
- formattingEnabled
- Boolean
true
görüntülenen verileri biçimlendirmek için; aksi takdirde , false
.
- updateMode
- DataSourceUpdateMode
Değerlerden DataSourceUpdateMode biri.
Döndürülenler
Yeni oluşturulan Binding.
Özel durumlar
tarafından propertyName
verilen özellik denetimde yok veya salt okunur.
-veya-
Belirtilen veri üyesi veri kaynağında yok.
-veya-
Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.
Açıklamalar
yöntemini çağırmak Add olayı tetikler CollectionChanged .
Şunlara uygulanır
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String)
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan ve bağlamayı koleksiyona ekleyen bir bağlama oluşturur.
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
Parametreler
- propertyName
- String
Bağlanacak denetim özelliğinin adı.
- dataMember
- String
Bağlanacak özellik veya liste.
- formattingEnabled
- Boolean
true
görüntülenen verileri biçimlendirmek için; aksi takdirde , false
.
- updateMode
- DataSourceUpdateMode
Değerlerden DataSourceUpdateMode biri.
- formatString
- String
Bir değerin nasıl görüntüleneceğini gösteren bir veya daha fazla biçim belirtici karakteri.
Döndürülenler
Yeni oluşturulan Binding.
Özel durumlar
tarafından propertyName
verilen özellik denetimde yok veya salt okunur.
-veya-
Belirtilen veri üyesi veri kaynağında yok.
-veya-
Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.
Açıklamalar
yöntemini çağırmak Add olayı tetikler CollectionChanged .
Şunlara uygulanır
Add(String, Object, String, Boolean, DataSourceUpdateMode, Object, String, IFormatProvider)
Belirtilen denetim özelliğini belirtilen veri kaynağının belirtilen veri üyesine bağlayan, isteğe bağlı olarak belirtilen biçim dizesiyle biçimlendirmeyi etkinleştiren, değerleri belirtilen güncelleştirme ayarına göre veri kaynağına yayarak, veri kaynağından döndürülürken DBNull özelliği belirtilen değere ayarlayan, belirtilen biçim sağlayıcısını ayarlayan bir bağlama oluşturur. ve bağlamayı koleksiyona ekler.
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
Parametreler
- propertyName
- String
Bağlanacak denetim özelliğinin adı.
- dataMember
- String
Bağlanacak özellik veya liste.
- formattingEnabled
- Boolean
true
görüntülenen verileri biçimlendirmek için; aksi takdirde , false
.
- updateMode
- DataSourceUpdateMode
Değerlerden DataSourceUpdateMode biri.
- formatString
- String
Bir değerin nasıl görüntüleneceğini gösteren bir veya daha fazla biçim belirtici karakteri.
- formatInfo
- IFormatProvider
Varsayılan biçimlendirme davranışını geçersiz kılmak için uygulaması IFormatProvider .
Döndürülenler
Yeni oluşturulan Binding.
Özel durumlar
tarafından propertyName
verilen özellik denetimde yok veya salt okunur.
-veya-
Belirtilen veri üyesi veri kaynağında yok.
-veya-
Belirtilen veri kaynağı, veri üyesi veya denetim özelliği koleksiyondaki başka bir bağlamayla ilişkilendirilir.
Açıklamalar
yöntemini çağırmak Add olayı tetikler CollectionChanged .