BindingManagerBase Sınıf

Tanım

public ref class BindingManagerBase abstract

public abstract class BindingManagerBase

type BindingManagerBase = class

Public MustInherit Class BindingManagerBase

Devralma

Object

BindingManagerBase

Türetilmiş

System.Windows.Forms.CurrencyManager

System.Windows.Forms.PropertyManager

Örnekler

Aşağıdaki kod örneği, belirli bir veri kaynağı için bir BindingManagerBase döndürmek için öğesini kullanırBindingContext. (Örnekte, modülün Bildirimler bölümünde bildirdiğiniz myBindingManagerBase varsayılır.) Örnek daha sonra ve PositionChanged olaylarına olay temsilcileri CurrentChanged ekler. Son olarak, örnekte özelliği artıran veya azalan Position ve MoveLastlistedeki ilk veya son satıra ayarlayan Position dört yöntem (MoveNext, MovePrevious, MoveFirstve ) bulunur. Listedeki son satır özelliği kullanılarak Count belirlenir.

void GetBindingManagerBase()
{
   
   /* CustomersToOrders is the RelationName of a DataRelation. 
      Therefore, the list maintained by the BindingManagerBase is the
      list of orders that belong to a specific customer in the 
      DataTable named Customers, found in DataSet1. */
   myBindingManagerBase = this->BindingContext[DataSet1, "Customers.CustomersToOrders"];
   
   // Adds delegates to the CurrentChanged and PositionChanged events.
   myBindingManagerBase->PositionChanged += gcnew EventHandler( this, &Form1::BindingManagerBase_PositionChanged );
   myBindingManagerBase->CurrentChanged += gcnew EventHandler( this, &Form1::BindingManagerBase_CurrentChanged );
}

void BindingManagerBase_PositionChanged( Object^ sender, EventArgs^ /*e*/ )
{
   
   // Prints the new Position of the BindingManagerBase.
   Console::Write( "Position Changed: " );
   Console::WriteLine( (dynamic_cast<BindingManagerBase^>(sender))->Position );
}

void BindingManagerBase_CurrentChanged( Object^ sender, EventArgs^ /*e*/ )
{
   
   // Prints the new value of the current object.
   Console::Write( "Current Changed: " );
   Console::WriteLine( (dynamic_cast<BindingManagerBase^>(sender))->Current );
}

void MoveNext()
{
   
   // Increments the Position property value by one.
   myBindingManagerBase->Position = myBindingManagerBase->Position + 1;
}

void MovePrevious()
{
   
   // Decrements the Position property value by one.
   myBindingManagerBase->Position = myBindingManagerBase->Position - 1;
}

void MoveFirst()
{
   
   // Goes to the first row in the list.
   myBindingManagerBase->Position = 0;
}

void MoveLast()
{
   
   // Goes to the last row in the list.
   myBindingManagerBase->Position = myBindingManagerBase->Count - 1;
}

private void GetBindingManagerBase()
{
   /* CustomersToOrders is the RelationName of a DataRelation. 
   Therefore, the list maintained by the BindingManagerBase is the
   list of orders that belong to a specific customer in the 
   DataTable named Customers, found in DataSet1. */
   myBindingManagerBase = 
   this.BindingContext[DataSet1, "Customers.CustomersToOrders"];

   // Adds delegates to the CurrentChanged and PositionChanged events.
   myBindingManagerBase.PositionChanged += 
   new EventHandler(BindingManagerBase_PositionChanged);
   myBindingManagerBase.CurrentChanged +=
   new EventHandler(BindingManagerBase_CurrentChanged);
}

private void BindingManagerBase_PositionChanged
(object sender, EventArgs e)
{
   // Prints the new Position of the BindingManagerBase.
   Console.Write("Position Changed: ");
   Console.WriteLine(((BindingManagerBase)sender).Position);
}

private void BindingManagerBase_CurrentChanged
(object sender, EventArgs e)
{
   // Prints the new value of the current object.
   Console.Write("Current Changed: ");
   Console.WriteLine(((BindingManagerBase)sender).Current);
}

private void MoveNext()
{
   // Increments the Position property value by one.
   myBindingManagerBase.Position += 1;
}

private void MovePrevious()
{
   // Decrements the Position property value by one.
   myBindingManagerBase.Position -= 1;
}

private void MoveFirst()
{
   // Goes to the first row in the list.
   myBindingManagerBase.Position = 0;
}

private void MoveLast()
{
   // Goes to the last row in the list.
   myBindingManagerBase.Position = 
   myBindingManagerBase.Count - 1;
}

Private Sub GetBindingManagerBase
   ' CustomersToOrders is the RelationName of a DataRelation.
   ' Therefore, the list maintained by the BindingManagerBase is the
   ' list of orders that belong to a specific customer in the
   ' DataTable named Customers, found in DataSet.
   myBindingManagerBase = Me.BindingContext(DataSet1, _
   "Customers.CustomersToOrders")

   ' Adds delegates to the CurrentChanged and PositionChanged events.
   AddHandler myBindingManagerBase.PositionChanged, _
   AddressOf BindingManagerBase_PositionChanged
   AddHandler myBindingManagerBase.CurrentChanged, _
   AddressOf BindingManagerBase_CurrentChanged
End Sub

Private Sub BindingManagerBase_PositionChanged _
(sender As Object, e As EventArgs)

   ' Prints the new Position of the BindingManagerBase.
   Console.Write("Position Changed: ")
   Console.WriteLine(CType(sender, BindingManagerBase).Position)
End Sub

Private Sub BindingManagerBase_CurrentChanged _
(sender As Object, e As EventArgs)

   ' Prints the new value of the current object.
   Console.Write("Current Changed: ")
   Console.WriteLine(CType(sender, BindingManagerBase).Current)
End Sub

Private Sub MoveNext
   ' Increments the Position property value by one.
   myBindingManagerBase.Position += 1
End Sub

Private Sub MovePrevious
   ' Decrements the Position property value by one.
   myBindingManagerBase.Position -= 1
End Sub

Private Sub MoveFirst
   ' Goes to the first row in the list.
   myBindingManagerBase.Position = 0
End Sub

Private Sub MoveLast
   ' Goes to the last row in the list.
   myBindingManagerBase.Position = _
   myBindingManagerBase.Count - 1
End Sub

Açıklamalar

, BindingManagerBase aynı veri kaynağına bağlı bir Windows Formunda veriye bağlı denetimlerin eşitlenmesini sağlar. (Bir denetimi veri kaynağına bağlama hakkında daha fazla bilgi için sınıfına Binding bakın.) Örneğin, bir formun aynı veri kaynağına ancak farklı sütunlara bağlı iki TextBox denetim içerdiğini varsayalım. Veri kaynağı, müşteri adlarını içeren bir DataTable kaynak olabilirken, sütunlar ad ve soyadlarını içerebilir. Aynı müşteri için doğru ad ve soyadların birlikte görüntülenmesi için iki denetimin eşitlenmesi gerekir. CurrencyManagersınıfından devralınan öğesi, veri kaynağındaki BindingManagerBase geçerli öğeye yönelik bir işaretçi tutarak bu eşitlemeyi gerçekleştirir. Denetimler TextBox geçerli öğeye bağlı olduğundan, aynı satıra ait bilgileri görüntüler. Geçerli öğe değiştiğinde CurrencyManager , tüm ilişkili denetimleri bilgilendirerek verilerini yenileyebilmelerini sağlar. Ayrıca, özelliğini denetimlerin Position işaret olduğu satırda DataTable belirtecek şekilde ayarlayabilirsiniz. Veri kaynağında kaç satır olduğunu belirlemek için özelliğini kullanın Count .

CurrencyManager veri kaynaklarının bir geçerli öğe işaretçisi tutmaması nedeniyle gereklidir. Örneğin, diziler ve ArrayList nesneler veri kaynakları olabilir, ancak geçerli öğeyi döndüren bir özelliği yoktur. Geçerli öğeyi almak için özelliğini kullanın Current .

PropertyManager ayrıca öğesinden BindingManagerBasedevralınır ve bir veri kaynağındaki geçerli nesnenin özelliği yerine bir nesnenin geçerli özelliğini korumak için kullanılır. Bu nedenle, için veya Count özelliğini PropertyManager ayarlamaya Position çalışmak hiçbir etkisi olmaz.

oluşturmak BindingManagerBaseiçin, yönetilen veri kaynağına bağlı olarak veya CurrencyManagerPropertyManagerdöndüren sınıfını kullanınBindingContext.

Çözüm programcıların denetimleri doğrudan bir BindingSource bileşene bağlaması teşvik edilir. Bu bileşen, gerçek hedef veri kaynağına hem veri kaynağı hem de veri bağlayıcısı işlevi görür. BindingSource denetim ile hedefi arasındaki para birimini yönetmek de dahil olmak üzere hem basit hem de karmaşık veri bağlamayı büyük ölçüde basitleştirir.

Uygulayanlara Notlar

'den BindingManagerBasedevraldığınızda, şu soyut üyeleri geçersiz kılmalısınız: AddNew(), Count, CancelCurrentEdit(), Current, EndCurrentEdit(), , GetItemProperties(), OnCurrentChanged(EventArgs), Position, RemoveAt(Int32), , ResumeBinding(), SuspendBinding()ve UpdateIsBinding().

Oluşturucular

Alanlar

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• BindingSource
• BindingContext
• CurrencyManager
• PropertyManager