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 vytvoří vazbu TextBox ovládacího prvku 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

Odvozuje CurrencyManager se od BindingManagerBase třídy. Použijte k BindingContext vrácení znaku nebo znaku PropertyManagerCurrencyManager . Skutečný vrácený objekt závisí na zdroji dat a členu Item[] dat předané vlastnosti objektu BindingContext. Pokud je zdrojem dat objekt, který může vrátit pouze jednu vlastnost (místo seznamu objektů), typ bude .PropertyManager Pokud například zadáte TextBox jako zdroj dat, PropertyManager vrátí se hodnota. Pokud je na druhou stranu zdrojem dat objekt, který implementuje IList, IListSourcenebo IBindingList rozhraní, bude vrácena CurrencyManager .

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 nastavena na true, můžete použít metodu AddNew .

Pole

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

Vlastnosti

Name	Description
Bindings	Získá kolekci vazeb, které se spravují. (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 toto CurrencyManager.
Position	Získá nebo nastaví pozici, na které jste v seznamu.

Metody

Name	Description
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.
GetItemProperties()	Získá kolekci popisovače vlastností pro podkladový seznam.
GetItemProperties(ArrayList, ArrayList)	Získá kolekci popisovačů vlastností pro vazbu pomocí zadaného ArrayList. (Zděděno od BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Získá seznam vlastností položek spravovaných tímto BindingManagerBase. (Zděděno od BindingManagerBase)
GetListName(ArrayList)	Získá název seznamu, který poskytuje data pro vazbu pomocí zadané sady vázaných vlastností.
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 vrací žá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 vrá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 v zadaném indexu.
ResumeBinding()	Obnoví datová vazba.
SuspendBinding()	Pozastaví datová vazba, aby se zabránilo změnám v aktualizaci vázaného zdroje dat.
UpdateIsBinding()	Aktualizuje stav vazby.

Událost

Name	Description
BindingComplete	Nastane při dokončení operace datové vazby. (Zděděno od BindingManagerBase)
CurrentChanged	Nastane, když se aktuálně vázaná položka změní. (Zděděno od BindingManagerBase)
CurrentItemChanged	Nastane, když se změní stav aktuálně vázané položky. (Zděděno od BindingManagerBase)
DataError	Nastane, když Exception je bezobslužně zpracována BindingManagerBase. (Zděděno od BindingManagerBase)
ItemChanged	Nastane, když byla aktuální položka změněna.
ListChanged	Nastane, když se změní seznam nebo položka v seznamu se změní.
MetaDataChanged	Nastane, když se změní metadata objektu List .
PositionChanged	Nastane po změně hodnoty Position vlastnosti. (Zděděno od BindingManagerBase)

Viz také

• BindingsCollection
• BindingContext
• Binding