BindingManagerBase Klas

Definitie

public ref class BindingManagerBase abstract

public abstract class BindingManagerBase

type BindingManagerBase = class

Public MustInherit Class BindingManagerBase

Overname

Object

BindingManagerBase

Afgeleid

System.Windows.Forms.CurrencyManager

System.Windows.Forms.PropertyManager

Voorbeelden

In het volgende codevoorbeeld wordt de BindingContext functie gebruikt om een BindingManagerBase voor een specifieke gegevensbron te retourneren. (In het voorbeeld wordt ervan uitgegaan dat u hebt gedeclareerd myBindingManagerBase in de sectie Declaraties van de module.) In het voorbeeld worden vervolgens gedelegeerden aan de CurrentChanged gebeurtenis en PositionChanged gebeurtenissen toegevoegd. Ten slotte bevat het voorbeeld vier methoden (, , en ) die de MoveNext eigenschap verhogen of verlagen en de MovePrevious eigenschap instellen op de eerste of laatste rij in de lijst.MoveFirstMoveLastPositionPosition De laatste rij in de lijst wordt bepaald met behulp van de Count eigenschap.

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

Opmerkingen

Met de BindingManagerBase kunt u gegevensgebonden besturingselementen synchroniseren op een Windows Formulier dat is gebonden aan dezelfde gegevensbron. (Zie de Binding klasse voor meer informatie over het eenvoudig binden van een besturingselement aan een gegevensbron.) Stel dat een formulier twee TextBox besturingselementen bevat die zijn gebonden aan dezelfde gegevensbron, maar aan verschillende kolommen. De gegevensbron kan een DataTable gegevensbron zijn die klantnamen bevat, terwijl de kolommen mogelijk de voor- en achternamen bevatten. De twee besturingselementen moeten worden gesynchroniseerd om de juiste voor- en achternamen samen voor dezelfde klant weer te geven. De CurrencyManager, die overgaat van de BindingManagerBase klasse, voert deze synchronisatie uit door een aanwijzer te onderhouden naar het huidige item in de gegevensbron. De TextBox besturingselementen zijn gebonden aan het huidige item, zodat ze de informatie voor dezelfde rij weergeven. Wanneer het huidige item wordt gewijzigd, CurrencyManager worden alle afhankelijke besturingselementen op de hoogte gehouden, zodat ze hun gegevens kunnen vernieuwen. Bovendien kunt u de Position eigenschap instellen om de rij op te geven in de DataTable rij waarnaar de besturingselementen verwijzen. Als u wilt bepalen hoeveel rijen in de gegevensbron aanwezig zijn, gebruikt u de Count eigenschap.

Dit CurrencyManager is nodig omdat gegevensbronnen niet noodzakelijkerwijs een aanwijzer voor huidig item onderhouden. Matrices en ArrayList objecten kunnen bijvoorbeeld gegevensbronnen zijn, maar ze hebben geen eigenschap die het huidige item retourneert. Gebruik de eigenschap om het huidige item op te Current halen.

De PropertyManager eigenschap neemt ook over van de BindingManagerBase, en wordt gebruikt om de huidige eigenschap van een object te behouden, in plaats van de eigenschap van een huidig object in een gegevensbron. Daarom heeft het instellen van de Position of Count eigenschap voor een PropertyManager eigenschap geen effect.

Als u een BindingManagerBase, gebruikt u de BindingContext klasse, die een CurrencyManager of een PropertyManager, retourneert, afhankelijk van de gegevensbron die wordt beheerd.

Oplossingsprogrammeurs worden aangemoedigd om besturingselementen rechtstreeks aan een BindingSource onderdeel te binden, die als zowel een gegevensbron als een gegevensconnector fungeert voor de werkelijke doelgegevensbron. BindingSource vereenvoudigt zowel eenvoudige als complexe gegevensbindingen, waaronder het beheren van valuta tussen de controle en het doel ervan.

Notities voor uitvoerders

Wanneer u overdrat van BindingManagerBase, moet u de volgende abstracte leden overschrijven: AddNew(), CountCancelCurrentEdit()CurrentEndCurrentEdit(), GetItemProperties()OnCurrentChanged(EventArgs)PositionRemoveAt(Int32)ResumeBinding(), , en . SuspendBinding()UpdateIsBinding()

Zie ook

• BindingSource
• BindingContext
• CurrencyManager
• PropertyManager