CurrencyManager Třída

Definice

Spravuje seznam Binding objektů.Manages a list of Binding objects.

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
CurrencyManager

Příklady

Následující příklad kódu váže TextBox ovládací prvek na sloupec v DataTable , získá CurrencyManager pro vazbu a nastaví jeho pozici.The following code example binds a TextBox control to a column in a DataTable, gets the CurrencyManager for the binding, and sets its position.

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

Je CurrencyManager odvozen z BindingManagerBase třídy.The CurrencyManager derives from the BindingManagerBase class. Použijte BindingContext k vrácení CurrencyManager nebo PropertyManager .Use the BindingContext to return either a CurrencyManager or a PropertyManager. Skutečný vrácený objekt závisí na zdroji dat a datovém členu předaném do Item[] vlastnosti objektu BindingContext .The actual object returned depends on the data source and data member passed to the Item[] property of the BindingContext. Pokud je zdrojem dat objekt, který může vracet pouze jednu vlastnost (namísto seznamu objektů), bude typ PropertyManager .If the data source is an object that can return only a single property (instead of a list of objects), the type will be a PropertyManager. Pokud například zadáte TextBox jako zdroj dat a, PropertyManager bude vrácena.For example, if you specify a TextBox as the data source, a PropertyManager will be returned. Pokud je naopak zdrojem dat objekt, který implementuje IList IListSource rozhraní, nebo IBindingList , CurrencyManager bude vrácena.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

CurrentVlastnost vrátí aktuální položku v podkladovém seznamu.The Current property returns the current item in the underlying list. Chcete-li změnit aktuální položku, nastavte Position vlastnost na novou hodnotu.To change the current item, set the Position property to a new value. Hodnota musí být větší než 0 a musí být menší než hodnota Count Vlastnosti.The value must be greater than 0 and must be less than the value of the Count property.

Pokud podkladový zdroj dat implementuje IBindingList rozhraní a AllowNew vlastnost je nastavena na hodnotu true , lze použít AddNew metodu.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Pole

finalType

Určuje datový typ seznamu.Specifies the data type of the list.

listposition

Určuje aktuální pozici CurrencyManager v seznamu.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler

Určuje obslužnou rutinu události pro CurrentChanged událost.Specifies the event handler for the CurrentChanged event.

(Zděděno od BindingManagerBase)
onPositionChangedHandler

Určuje obslužnou rutinu události pro PositionChanged událost.Specifies the event handler for the PositionChanged event.

(Zděděno od BindingManagerBase)

Vlastnosti

Bindings

Získá kolekci vazeb, které jsou spravovány.Gets the collection of bindings being managed.

(Zděděno od BindingManagerBase)
Count

Získá počet položek v seznamu.Gets the number of items in the list.

Current

Načte aktuální položku v seznamu.Gets the current item in the list.

IsBindingSuspended

Načte hodnotu, která označuje, zda je vazba pozastavena.Gets a value indicating whether binding is suspended.

(Zděděno od BindingManagerBase)
List

Získá seznam pro tento CurrencyManager .Gets the list for this CurrencyManager.

Position

Získá nebo nastaví pozici, kterou jste v seznamu.Gets or sets the position you are at within the list.

Metody

AddNew()

Přidá novou položku do základního seznamu.Adds a new item to the underlying list.

CancelCurrentEdit()

Zruší aktuální operaci úprav.Cancels the current edit operation.

CheckEmpty()

Vyvolá výjimku, pokud neexistuje seznam, nebo je seznam prázdný.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit()

Ukončí aktuální operaci úprav.Ends the current edit operation.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

(Zděděno od Object)
GetItemProperties()

Získá kolekci popisovačů vlastností pro základní seznam.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList)

Získá kolekci popisovačů vlastnosti pro vazbu pomocí zadaného prvku ArrayList .Gets the collection of property descriptors for the binding using the specified ArrayList.

(Zděděno od BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)

Získá seznam vlastností položek spravovaných tímto BindingManagerBase .Gets the list of properties of the items managed by this 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í.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType()

Získá Type aktuální instanci.Gets the Type of the current instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

(Zděděno od Object)
OnBindingComplete(BindingCompleteEventArgs)

Vyvolá BindingComplete událost.Raises the BindingComplete event.

(Zděděno od BindingManagerBase)
OnCurrentChanged(EventArgs)

Vyvolá CurrentChanged událost.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs)

Vyvolá CurrentItemChanged událost.Raises the CurrentItemChanged event.

OnCurrentItemChanged(EventArgs)

Vyvolá CurrentItemChanged událost.Raises the CurrentItemChanged event.

(Zděděno od BindingManagerBase)
OnDataError(Exception)

Vyvolá DataError událost.Raises the DataError event.

(Zděděno od BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)

Vyvolá ItemChanged událost.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs)

Vyvolá MetaDataChanged událost.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs)

Vyvolá PositionChanged událost.Raises the PositionChanged event.

PullData()

Vyžádá data z ovládacího prvku vázaného na data do zdroje dat a nevrátí žádné informace.Pulls data from the data-bound control into the data source, returning no information.

(Zděděno od BindingManagerBase)
PushData()

Vloží data ze zdroje dat do ovládacího prvku vázaného na data a nevrátí žádné informace.Pushes data from the data source into the data-bound control, returning no information.

(Zděděno od BindingManagerBase)
Refresh()

Vynutí opakované naplnění seznamu vázaného na data.Forces a repopulation of the data-bound list.

RemoveAt(Int32)

Odebere položku z pozice se zadaným indexem.Removes the item at the specified index.

ResumeBinding()

Obnoví datovou vazbu.Resumes data binding.

SuspendBinding()

Pozastaví datovou vazbu, aby zabránila změnám v aktualizaci vázaného zdroje dat.Suspends data binding to prevents changes from updating the bound data source.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)
UpdateIsBinding()

Aktualizuje stav vazby.Updates the status of the binding.

Události

BindingComplete

Nastane při dokončení operace datové vazby.Occurs at the completion of a data-binding operation.

(Zděděno od BindingManagerBase)
CurrentChanged

Nastane, pokud se změní aktuálně svázaná položka.Occurs when the currently bound item changes.

(Zděděno od BindingManagerBase)
CurrentItemChanged

Nastane, pokud se změní stav aktuálně vázané položky.Occurs when the state of the currently bound item changes.

(Zděděno od BindingManagerBase)
DataError

Nastane, pokud Exception se spustí tichá zpracování BindingManagerBase .Occurs when an Exception is silently handled by the BindingManagerBase.

(Zděděno od BindingManagerBase)
ItemChanged

Vyvolá se v případě, že byla aktuální položka změněna.Occurs when the current item has been altered.

ListChanged

Vyvolá se v případě, že se změní seznam nebo dojde ke změně položky v seznamu.Occurs when the list changes or an item in the list changes.

MetaDataChanged

Vyvolá se v případě, že se List změnila metadata.Occurs when the metadata of the List has changed.

PositionChanged

Vyvolá se po Position změně hodnoty vlastnosti.Occurs after the value of the Position property has changed.

(Zděděno od BindingManagerBase)

Platí pro

Viz také