CurrencyManager Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

CurrencyManager.cs

Spravuje seznam Binding objektů.

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

Dědičnost

Object

BindingManagerBase

CurrencyManager

Příklady

Následující příklad kódu váže TextBox ovládací prvek na sloupec v objektu DataTable, získá CurrencyManager pro vazbu a nastaví jeho pozici.

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

Poznámky

Třída je CurrencyManager odvozena BindingManagerBase od třídy . BindingContext Použijte k vrácení buď , CurrencyManager nebo PropertyManager. Skutečný vrácený objekt závisí na zdroji dat a datovém členu předaném Item[] vlastnosti objektu BindingContext. Pokud je zdrojem dat objekt, který může vrátit pouze jednu vlastnost (místo seznamu objektů), bude typem PropertyManager. Pokud například jako zdroj dat zadáte TextBox , vrátí se hodnota .PropertyManager Pokud je zdroj dat objektem, který implementuje IListrozhraní , IListSourcenebo IBindingList , CurrencyManager vrátí se .

Vlastnost Current vrátí aktuální položku v podkladovém seznamu. Chcete-li změnit aktuální položku, nastavte Position vlastnost na novou hodnotu. Hodnota musí být větší než 0 a musí být menší než hodnota Count vlastnosti.

Pokud podkladový zdroj dat implementuje IBindingList rozhraní a AllowNew vlastnost je nastavená na true, můžete použít metodu AddNew .

Pole

finalType	Určuje datový typ seznamu.
listposition	Určuje aktuální pozici položky CurrencyManager v seznamu.
onCurrentChangedHandler	Určuje obslužnou rutinu CurrentChanged události pro událost. (Zděděno od BindingManagerBase)
onPositionChangedHandler	Určuje obslužnou rutinu PositionChanged události pro událost. (Zděděno od BindingManagerBase)

Vlastnosti

Bindings	Získá kolekci vazeb, které jsou spravovány. (Zděděno od BindingManagerBase)
Count	Získá počet položek v seznamu.
Current	Získá aktuální položku v seznamu.
IsBindingSuspended	Získá hodnotu označující, zda je vazba pozastavena. (Zděděno od BindingManagerBase)
List	Získá seznam pro tento CurrencyManager.
Position	Získá nebo nastaví pozici, na které se nacházíte v seznamu.

Metody

AddNew()	Přidá novou položku do podkladového seznamu.
CancelCurrentEdit()	Zruší aktuální operaci úprav.
CheckEmpty()	Vyvolá výjimku, pokud neexistuje žádný seznam nebo je seznam prázdný.
EndCurrentEdit()	Ukončí aktuální operaci úprav.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetItemProperties()	Získá kolekci popisovače vlastností podkladového seznamu.
GetItemProperties(ArrayList, ArrayList)	Získá kolekci popisovačů vlastností pro vazbu pomocí zadané ArrayList. (Zděděno od BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Získá seznam vlastností položek spravovaných tímto BindingManagerBaseobjektem . (Zděděno od BindingManagerBase)
GetListName(ArrayList)	Získá název seznamu poskytující data pro vazbu pomocí zadané sady vázaných vlastností.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
OnBindingComplete(BindingCompleteEventArgs)	BindingComplete Vyvolá událost. (Zděděno od BindingManagerBase)
OnCurrentChanged(EventArgs)	CurrentChanged Vyvolá událost.
OnCurrentItemChanged(EventArgs)	CurrentItemChanged Vyvolá událost.
OnDataError(Exception)	DataError Vyvolá událost. (Zděděno od BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	ItemChanged Vyvolá událost.
OnMetaDataChanged(EventArgs)	MetaDataChanged Vyvolá událost.
OnPositionChanged(EventArgs)	PositionChanged Vyvolá událost.
PullData()	Načítá data z ovládacího prvku vázaného na data do zdroje dat a nevrací žádné informace. (Zděděno od BindingManagerBase)
PushData()	Nasdílí data ze zdroje dat do ovládacího prvku vázaného na data a nevrátí žádné informace. (Zděděno od BindingManagerBase)
Refresh()	Vynutí opětovné naplnění seznamu vázaného na data.
RemoveAt(Int32)	Odebere položku z pozice se zadaným indexem.
ResumeBinding()	Obnoví datová vazba.
SuspendBinding()	Pozastaví datová vazba, aby se zabránilo změnám v aktualizaci vázaného zdroje dat.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
UpdateIsBinding()	Aktualizace stav vazby.

Událost

BindingComplete	Vyskytuje se při dokončení operace vazby dat. (Zděděno od BindingManagerBase)
CurrentChanged	Vyvolá se při změně aktuálně vázané položky. (Zděděno od BindingManagerBase)
CurrentItemChanged	Vyvolá se při změně stavu aktuálně vázané položky. (Zděděno od BindingManagerBase)
DataError	Vyvolá se při tichém Exception zpracování objektem BindingManagerBase. (Zděděno od BindingManagerBase)
ItemChanged	Vyvolá se při změně aktuální položky.
ListChanged	Vyvolá se při změně seznamu nebo položky v seznamu.
MetaDataChanged	Vyvolá se při změně metadat objektu List .
PositionChanged	Vyvolá se po změně hodnoty Position vlastnosti. (Zděděno od BindingManagerBase)

Viz také

• BindingsCollection
• BindingContext
• Binding