CurrencyManager Klasa

Definicja

Zarządza listą Binding obiektów.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
Dziedziczenie
CurrencyManager

Przykłady

Poniższy przykład kodu wiąże TextBox formant z kolumną w DataTable , pobiera CurrencyManager dla powiązania i ustawia jego pozycję.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

Uwagi

CurrencyManagerDziedziczy z BindingManagerBase klasy.The CurrencyManager derives from the BindingManagerBase class. Użyj, BindingContext Aby zwrócić albo CurrencyManager lub PropertyManager .Use the BindingContext to return either a CurrencyManager or a PropertyManager. Rzeczywisty zwrócony obiekt zależy od źródła danych i elementu członkowskiego danych przekazana do Item[] właściwości BindingContext .The actual object returned depends on the data source and data member passed to the Item[] property of the BindingContext. Jeśli źródło danych jest obiektem, który może zwrócić tylko jedną właściwość (zamiast listy obiektów), typ będzie 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. Na przykład, jeśli określisz TextBox jako źródło danych, PropertyManager zostanie zwrócone.For example, if you specify a TextBox as the data source, a PropertyManager will be returned. Jeśli z drugiej strony, źródło danych jest obiektem, który implementuje IList IListSource interfejs,, lub IBindingList , CurrencyManager zostanie zwrócony.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

CurrentWłaściwość zwraca bieżący element na liście podstawowej.The Current property returns the current item in the underlying list. Aby zmienić bieżący element, należy ustawić Position nową wartość właściwości.To change the current item, set the Position property to a new value. Wartość musi być większa niż 0 i musi być mniejsza niż wartość Count właściwości.The value must be greater than 0 and must be less than the value of the Count property.

Jeśli bazowe źródło danych implementuje IBindingList interfejs, a AllowNew Właściwość jest ustawiona na true , można użyć AddNew metody.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Pola

finalType

Określa typ danych listy.Specifies the data type of the list.

listposition

Określa bieżącą pozycję na CurrencyManager liście.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler

Określa program obsługi zdarzeń dla CurrentChanged zdarzenia.Specifies the event handler for the CurrentChanged event.

(Odziedziczone po BindingManagerBase)
onPositionChangedHandler

Określa program obsługi zdarzeń dla PositionChanged zdarzenia.Specifies the event handler for the PositionChanged event.

(Odziedziczone po BindingManagerBase)

Właściwości

Bindings

Pobiera kolekcję zarządzanych powiązań.Gets the collection of bindings being managed.

(Odziedziczone po BindingManagerBase)
Count

Pobiera liczbę elementów na liście.Gets the number of items in the list.

Current

Pobiera bieżący element z listy.Gets the current item in the list.

IsBindingSuspended

Pobiera wartość wskazującą, czy powiązanie jest zawieszone.Gets a value indicating whether binding is suspended.

(Odziedziczone po BindingManagerBase)
List

Pobiera listę dla tego elementu CurrencyManager .Gets the list for this CurrencyManager.

Position

Pobiera lub ustawia pozycję, która znajduje się na liście.Gets or sets the position you are at within the list.

Metody

AddNew()

Dodaje nowy element do listy podstawowej.Adds a new item to the underlying list.

CancelCurrentEdit()

Anuluje bieżącą operację edycji.Cancels the current edit operation.

CheckEmpty()

Zgłasza wyjątek, jeśli nie ma listy lub lista jest pusta.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit()

Zamyka bieżącą operację edycji.Ends the current edit operation.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetItemProperties()

Pobiera kolekcję deskryptora właściwości dla listy podstawowej.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList)

Pobiera kolekcję deskryptorów właściwości dla powiązania przy użyciu określonego elementu ArrayList .Gets the collection of property descriptors for the binding using the specified ArrayList.

(Odziedziczone po BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)

Pobiera listę właściwości elementów zarządzanych przez ten element BindingManagerBase .Gets the list of properties of the items managed by this BindingManagerBase.

(Odziedziczone po BindingManagerBase)
GetListName(ArrayList)

Pobiera nazwę listy dostarczającej dane dla powiązania przy użyciu określonego zestawu właściwości powiązanych.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnBindingComplete(BindingCompleteEventArgs)

Podnosi BindingComplete zdarzenie.Raises the BindingComplete event.

(Odziedziczone po BindingManagerBase)
OnCurrentChanged(EventArgs)

Podnosi CurrentChanged zdarzenie.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs)

Podnosi CurrentItemChanged zdarzenie.Raises the CurrentItemChanged event.

OnCurrentItemChanged(EventArgs)

Podnosi CurrentItemChanged zdarzenie.Raises the CurrentItemChanged event.

(Odziedziczone po BindingManagerBase)
OnDataError(Exception)

Podnosi DataError zdarzenie.Raises the DataError event.

(Odziedziczone po BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)

Podnosi ItemChanged zdarzenie.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs)

Podnosi MetaDataChanged zdarzenie.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs)

Podnosi PositionChanged zdarzenie.Raises the PositionChanged event.

PullData()

Pobiera dane z kontrolki powiązanej z danymi do źródła danych, zwracając brak informacji.Pulls data from the data-bound control into the data source, returning no information.

(Odziedziczone po BindingManagerBase)
PushData()

Wypchnij dane ze źródła danych do kontrolki powiązanej z danymi, zwracając brak informacji.Pushes data from the data source into the data-bound control, returning no information.

(Odziedziczone po BindingManagerBase)
Refresh()

Wymusza ponowne wypełnianie listy powiązanej z danymi.Forces a repopulation of the data-bound list.

RemoveAt(Int32)

Usuwa element pod określonym indeksem.Removes the item at the specified index.

ResumeBinding()

Wznawia powiązanie danych.Resumes data binding.

SuspendBinding()

Wstrzymuje powiązanie danych, aby zapobiegać zmianom aktualizacji powiązanego źródła danych.Suspends data binding to prevents changes from updating the bound data source.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)
UpdateIsBinding()

Aktualizuje stan powiązania.Updates the status of the binding.

Zdarzenia

BindingComplete

Występuje po zakończeniu operacji powiązania danych.Occurs at the completion of a data-binding operation.

(Odziedziczone po BindingManagerBase)
CurrentChanged

Występuje po zmianie aktualnie powiązanego elementu.Occurs when the currently bound item changes.

(Odziedziczone po BindingManagerBase)
CurrentItemChanged

Występuje, gdy zmienia się stan aktualnie powiązanego elementu.Occurs when the state of the currently bound item changes.

(Odziedziczone po BindingManagerBase)
DataError

Występuje, gdy element Exception jest obsługiwany dyskretnie przez BindingManagerBase .Occurs when an Exception is silently handled by the BindingManagerBase.

(Odziedziczone po BindingManagerBase)
ItemChanged

Występuje po zmianie bieżącego elementu.Occurs when the current item has been altered.

ListChanged

Występuje, gdy zmieni się lista lub element na liście ulegnie zmianie.Occurs when the list changes or an item in the list changes.

MetaDataChanged

Występuje, gdy metadane programu uległy List zmianie.Occurs when the metadata of the List has changed.

PositionChanged

Występuje po Position zmianie wartości właściwości.Occurs after the value of the Position property has changed.

(Odziedziczone po BindingManagerBase)

Dotyczy

Zobacz też