CurrencyManager Osztály

Definíció

Névtér:: System.Windows.Forms

Szerelvény:: System.Windows.Forms.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Az objektumok listáját Binding kezeli.

public ref class CurrencyManager : System::Windows::Forms::BindingManagerBase

public class CurrencyManager : System.Windows.Forms.BindingManagerBase

type CurrencyManager = class
    inherit BindingManagerBase

Public Class CurrencyManager
Inherits BindingManagerBase

Öröklődés: Object

BindingManagerBase
CurrencyManager

Példák

Az alábbi példakód egy vezérlőelemet TextBox egy oszlophoz köt egy DataTableadott oszlophoz, lekéri a CurrencyManager kötést, és beállítja a pozícióját.

CurrencyManager^ myCurrencyManager;
void BindControl( DataTable^ myTable )
{
   
   // Bind a TextBox control to a DataTable column in a DataSet.
   textBox1->DataBindings->Add( "Text", myTable, "CompanyName" );
   
   // Specify the CurrencyManager for the DataTable.
   this->myCurrencyManager = dynamic_cast<CurrencyManager^>(this->BindingContext[ myTable ]);
   
   // Set the initial Position of the control.
   this->myCurrencyManager->Position = 0;
}

void MoveNext( CurrencyManager^ myCurrencyManager )
{
   if ( myCurrencyManager->Position == myCurrencyManager->Count - 1 )
   {
      MessageBox::Show( "You're at end of the records" );
   }
   else
   {
      myCurrencyManager->Position += 1;
   }
}

void MoveFirst( CurrencyManager^ myCurrencyManager )
{
   myCurrencyManager->Position = 0;
}

void MovePrevious( CurrencyManager^ myCurrencyManager )
{
   if ( myCurrencyManager->Position == 0 )
   {
      MessageBox::Show( "You're at the beginning of the records." );
   }
   else
   {
      myCurrencyManager->Position -= 1;
   }
}

void MoveLast( CurrencyManager^ myCurrencyManager )
{
   myCurrencyManager->Position = myCurrencyManager->Count - 1;
}

private CurrencyManager myCurrencyManager;
 
 private void BindControl(DataTable myTable){
    // Bind a TextBox control to a DataTable column in a DataSet.
    textBox1.DataBindings.Add("Text", myTable, "CompanyName");
    // Specify the CurrencyManager for the DataTable.
    myCurrencyManager = (CurrencyManager)this.BindingContext[myTable];
    // Set the initial Position of the control.
    myCurrencyManager.Position = 0;
 }
 
 private void MoveNext(CurrencyManager myCurrencyManager){
    if (myCurrencyManager.Position == myCurrencyManager.Count - 1){
       MessageBox.Show("You're at end of the records");
    }
    else{
      myCurrencyManager.Position += 1;
    }
 }
 
 private void MoveFirst(CurrencyManager myCurrencyManager){
    myCurrencyManager.Position = 0;
 }
 
 private void MovePrevious(CurrencyManager myCurrencyManager ){
    if(myCurrencyManager.Position == 0) {
       MessageBox.Show("You're at the beginning of the records.");
    }   
    else{
       myCurrencyManager.Position -= 1;
    }
 }
 
 private void MoveLast(CurrencyManager myCurrencyManager){
    myCurrencyManager.Position = myCurrencyManager.Count - 1;
 }

' Place the next line into the Declarations section of the form.
 Private myCurrencyManager As CurrencyManager
 
 Private Sub BindControl(myTable As DataTable)
    ' Bind a TextBox control to a DataTable column in a DataSet.
    TextBox1.DataBindings.Add("Text", myTable, "CompanyName")
    ' Specify the CurrencyManager for the DataTable.
    myCurrencyManager = CType(me.BindingContext(myTable), CurrencyManager)
    ' Set the initial Position of the control.
    myCurrencyManager.Position = 0
 End Sub
 
 Private Sub MoveNext(myCurrencyManager As CurrencyManager)
    If myCurrencyManager.Position = myCurrencyManager.Count - 1 Then 
       MessageBox.Show("You're at end of the records")
    Else
       myCurrencyManager.Position += 1
    End If
 End Sub
 
 Private Sub MoveFirst(myCurrencyManager As CurrencyManager)
    myCurrencyManager.Position = 0
 End Sub
 
 Private Sub MovePrevious(myCurrencyManager As CurrencyManager)
    If myCurrencyManager.Position = 0 Then
       MessageBox.Show("You're at the beginning of the records.")
    Else
       myCurrencyManager.Position -= 1
    End if
 End Sub
 
 Private Sub MoveLast(myCurrencyManager As CurrencyManager)
    myCurrencyManager.Position = myCurrencyManager.Count - 1
 End Sub

Megjegyzések

Az CurrencyManager osztályból BindingManagerBase származik. Az a BindingContext vagy egy PropertyManagerértéket adja visszaCurrencyManager. A visszaadott tényleges objektum az adatforrástól és a tulajdonságnak Item[]BindingContextátadott adatelemtől függ. Ha az adatforrás olyan objektum, amely csak egyetlen tulajdonságot tud visszaadni (az objektumok listája helyett), a típus egy PropertyManager. Ha például adatforrásként ad meg egy TextBox értéket, PropertyManager a rendszer egy értéket ad vissza. Ha viszont az adatforrás egy objektum, amely megvalósítja az IList, IListSourcevagy IBindingList interfészt, a rendszer visszaadja az a CurrencyManager értéket.

A Current tulajdonság az alapul szolgáló listában szereplő aktuális elemet adja vissza. Az aktuális elem módosításához állítsa be a Position tulajdonságot egy új értékre. Az értéknek 0-nál nagyobbnak kell lennie, és kisebbnek kell lennie, mint a Count tulajdonság értéke.

Ha a mögöttes adatforrás implementálja az IBindingList interfészt, és a AllowNew tulajdonság értéke truea következő, használhatja a metódust AddNew .

Mezők

Name	Description
finalType	A lista adattípusát adja meg.
listposition	A lista aktuális pozícióját CurrencyManager adja meg.
onCurrentChangedHandler	Az esemény eseménykezelőjének CurrentChanged megadása. (Öröklődés forrása BindingManagerBase)
onPositionChangedHandler	Az esemény eseménykezelőjének PositionChanged megadása. (Öröklődés forrása BindingManagerBase)

Tulajdonságok

Name	Description
Bindings	Lekéri a felügyelt kötések gyűjteményét. (Öröklődés forrása BindingManagerBase)
Count	Lekéri a lista elemeinek számát.
Current	Lekéri az aktuális elemet a listában.
IsBindingSuspended	Beolvas egy értéket, amely jelzi, hogy a kötés fel van-e függesztve. (Öröklődés forrása BindingManagerBase)
List	Lekéri ennek a listának a CurrencyManagerlistáját.
Position	Lekéri vagy beállítja a listán belüli pozíciót.

Metódusok

Name	Description
AddNew()	Új elemet ad hozzá az alapul szolgáló listához.
CancelCurrentEdit()	Megszakítja az aktuális szerkesztési műveletet.
CheckEmpty()	Kivételt jelez, ha nincs lista, vagy a lista üres.
EndCurrentEdit()	Befejezi az aktuális szerkesztési műveletet.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetItemProperties()	Lekéri a mögöttes lista tulajdonságleíró gyűjteményét.
GetItemProperties(ArrayList, ArrayList)	Lekéri a kötés tulajdonságleíróinak gyűjteményét a megadott ArrayListhasználatával. (Öröklődés forrása BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Lekéri az ez BindingManagerBaseáltal kezelt elemek tulajdonságait tartalmazó listát. (Öröklődés forrása BindingManagerBase)
GetListName(ArrayList)	Lekéri annak a listának a nevét, amely a kötés adatait adja meg a megadott kötött tulajdonságok halmazával.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
OnBindingComplete(BindingCompleteEventArgs)	Az eseményt emeli BindingComplete ki. (Öröklődés forrása BindingManagerBase)
OnCurrentChanged(EventArgs)	Az eseményt emeli CurrentChanged ki.
OnCurrentItemChanged(EventArgs)	Az eseményt emeli CurrentItemChanged ki.
OnDataError(Exception)	Az eseményt emeli DataError ki. (Öröklődés forrása BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Az eseményt emeli ItemChanged ki.
OnMetaDataChanged(EventArgs)	Az eseményt emeli MetaDataChanged ki.
OnPositionChanged(EventArgs)	Az eseményt emeli PositionChanged ki.
PullData()	Adatokat kér le az adathoz kötött vezérlőből az adatforrásba, és nem ad vissza információt. (Öröklődés forrása BindingManagerBase)
PushData()	Adatokat küld le az adatforrásból az adathoz kötött vezérlőbe, és nem ad vissza információt. (Öröklődés forrása BindingManagerBase)
Refresh()	Kényszeríti az adathoz kötött lista újratöltését.
RemoveAt(Int32)	Eltávolítja az elemet a megadott indexből.
ResumeBinding()	Folytatja az adatkötést.
SuspendBinding()	Felfüggeszti az adatkötést, hogy megakadályozza a kötött adatforrás frissítését.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)
UpdateIsBinding()	Frissíti a kötés állapotát.

esemény

Name	Description
BindingComplete	Adatkötési művelet befejezésekor következik be. (Öröklődés forrása BindingManagerBase)
CurrentChanged	Ez akkor fordul elő, ha a jelenleg kötött elem megváltozik. (Öröklődés forrása BindingManagerBase)
CurrentItemChanged	Az aktuálisan kötött elem állapota megváltozik. (Öröklődés forrása BindingManagerBase)
DataError	Akkor fordul elő, ha a Exception BindingManagerBase. (Öröklődés forrása BindingManagerBase)
ItemChanged	Az aktuális elem módosításakor következik be.
ListChanged	Akkor fordul elő, ha a lista vagy a lista egy eleme megváltozik.
MetaDataChanged	Akkor fordul elő, ha a metaadatok List megváltoztak.
PositionChanged	A tulajdonság értékének Position módosítása után következik be. (Öröklődés forrása BindingManagerBase)

A következőre érvényes:

Lásd még

Visszajelzés

Hasznosnak találta ezt az oldalt?