CurrencyManager Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
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. |
OnCurrentItemChanged(EventArgs) |
CurrentItemChanged Vyvolá událost. (Zděděno od BindingManagerBase) |
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) |