CurrencyManager CurrencyManager CurrencyManager CurrencyManager Class

Определение

Управляет списком объектов Binding.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
Наследование

Примеры

В следующем примере кода примере TextBox управления со столбцом в DataTable, получает CurrencyManager для привязки и устанавливает ее положение.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

Комментарии

CurrencyManager Является производным от BindingManagerBase класса.The CurrencyManager derives from the BindingManagerBase class. Используйте BindingContext для возврата либо CurrencyManager или PropertyManager.Use the BindingContext to return either a CurrencyManager or a PropertyManager. Фактический возвращенный объект зависит от источника данных и члена данных, передаваемых Item[Object] свойство BindingContext.The actual object returned depends on the data source and data member passed to the Item[Object] property of the BindingContext. Если источником данных является объект, который может возвращать только одно свойство (вместо списка объектов), то тип будет 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. Например, если указать TextBox как источник данных, PropertyManager будут возвращены.For example, if you specify a TextBox as the data source, a PropertyManager will be returned. Если, с другой стороны, источником данных является объект, реализующий IList, IListSource, или IBindingList интерфейс, CurrencyManager будут возвращены.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

Current Свойство возвращает текущий элемент в базовом списке.The Current property returns the current item in the underlying list. Чтобы изменить текущий элемент, установите Position присваивается новое значение.To change the current item, set the Position property to a new value. Значение должно быть больше 0 и должно быть меньше, чем значение Count свойства.The value must be greater than 0 and must be less than the value of the Count property.

Если базовый источник данных реализует IBindingList интерфейс и AllowNew свойству true, можно использовать AddNew метод.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

Поля

finalType finalType finalType finalType

Задает тип данных списка.Specifies the data type of the list.

listposition listposition listposition listposition

Задает текущую позицию объекта CurrencyManager в списке.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler

Задает обработчик для события CurrentChanged.Specifies the event handler for the CurrentChanged event.

(Inherited from BindingManagerBase)
onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler

Задает обработчик для события PositionChanged.Specifies the event handler for the PositionChanged event.

(Inherited from BindingManagerBase)

Свойства

Bindings Bindings Bindings Bindings

Получает коллекцию управляемых привязок.Gets the collection of bindings being managed.

(Inherited from BindingManagerBase)
Count Count Count Count

Возвращает число элементов в списке.Gets the number of items in the list.

Current Current Current Current

Получает текущий элемент в списке.Gets the current item in the list.

IsBindingSuspended IsBindingSuspended IsBindingSuspended IsBindingSuspended

Получает значение, показывающее, приостановлено ли действие привязки.Gets a value indicating whether binding is suspended.

(Inherited from BindingManagerBase)
List List List List

Получает список для данного объекта CurrencyManager.Gets the list for this CurrencyManager.

Position Position Position Position

Возвращает или задает текущую позицию в списке.Gets or sets the position you are at within the list.

Методы

AddNew() AddNew() AddNew() AddNew()

Добавляет новый элемент в базовый список.Adds a new item to the underlying list.

CancelCurrentEdit() CancelCurrentEdit() CancelCurrentEdit() CancelCurrentEdit()

Отменяет текущую операцию редактирования.Cancels the current edit operation.

CheckEmpty() CheckEmpty() CheckEmpty() CheckEmpty()

Создает исключение, если список отсутствует или пуст.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit() EndCurrentEdit() EndCurrentEdit() EndCurrentEdit()

Завершает текущую операцию редактирования.Ends the current edit operation.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetItemProperties() GetItemProperties() GetItemProperties() GetItemProperties()

Возвращает коллекцию дескрипторов свойств для базового списка.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList)

Получает коллекцию дескрипторов свойств для привязки с помощью указанного списка ArrayList.Gets the collection of property descriptors for the binding using the specified ArrayList.

(Inherited from BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList)

Получает список свойств элементов, управляемых этим объектом BindingManagerBase.Gets the list of properties of the items managed by this BindingManagerBase.

(Inherited from BindingManagerBase)
GetListName(ArrayList) GetListName(ArrayList) GetListName(ArrayList) GetListName(ArrayList)

Получает имя списка, предоставляющего данные для привязки, с использованием заданного набора связанных свойств.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs)

Вызывает событие BindingComplete.Raises the BindingComplete event.

(Inherited from BindingManagerBase)
OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs)

Создает событие CurrentChanged.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs)

Создает событие CurrentItemChanged.Raises the CurrentItemChanged event.

OnDataError(Exception) OnDataError(Exception) OnDataError(Exception) OnDataError(Exception)

Создает событие DataError.Raises the DataError event.

(Inherited from BindingManagerBase)
OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs)

Вызывает событие ItemChanged.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs)

Вызывает событие MetaDataChanged.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs)

Вызывает событие PositionChanged.Raises the PositionChanged event.

PullData() PullData() PullData() PullData()

Передает данные из привязанного к данным элемента управления в источник данных, не возвращая никаких сведений.Pulls data from the data-bound control into the data source, returning no information.

(Inherited from BindingManagerBase)
PushData() PushData() PushData() PushData()

Принудительно передает данные из источника данных в привязанный к данным элемент управления, не возвращая никаких сведений.Pushes data from the data source into the data-bound control, returning no information.

(Inherited from BindingManagerBase)
Refresh() Refresh() Refresh() Refresh()

Вызывает принудительное повторное заполнение списка с привязкой к данным.Forces a repopulation of the data-bound list.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Удаляет элемент с указанным индексом.Removes the item at the specified index.

ResumeBinding() ResumeBinding() ResumeBinding() ResumeBinding()

Возобновляет привязку данных.Resumes data binding.

SuspendBinding() SuspendBinding() SuspendBinding() SuspendBinding()

Приостанавливает действие привязки данных, чтобы предотвратить обновление привязанного источника данных в результате изменений.Suspends data binding to prevents changes from updating the bound data source.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
UpdateIsBinding() UpdateIsBinding() UpdateIsBinding() UpdateIsBinding()

Обновляет состояние привязки.Updates the status of the binding.

События

BindingComplete BindingComplete BindingComplete BindingComplete

Происходит во время завершения операции по привязке данных.Occurs at the completion of a data-binding operation.

(Inherited from BindingManagerBase)
CurrentChanged CurrentChanged CurrentChanged CurrentChanged

Происходит при изменении элемента, к которому имеется привязка.Occurs when the currently bound item changes.

(Inherited from BindingManagerBase)
CurrentItemChanged CurrentItemChanged CurrentItemChanged CurrentItemChanged

Происходит при изменении состояния элемента, к которому имеется привязка.Occurs when the state of the currently bound item changes.

(Inherited from BindingManagerBase)
DataError DataError DataError DataError

Происходит, когда исключение Exception автоматически обрабатывается объектом BindingManagerBase.Occurs when an Exception is silently handled by the BindingManagerBase.

(Inherited from BindingManagerBase)
ItemChanged ItemChanged ItemChanged ItemChanged

Происходит при изменении текущего элемента.Occurs when the current item has been altered.

ListChanged ListChanged ListChanged ListChanged

Происходит при изменениях в списке или при изменении элемента списка.Occurs when the list changes or an item in the list changes.

MetaDataChanged MetaDataChanged MetaDataChanged MetaDataChanged

Происходит при изменении метаданных объекта List.Occurs when the metadata of the List has changed.

PositionChanged PositionChanged PositionChanged PositionChanged

Происходит после изменения значения свойства Position.Occurs after the value of the Position property has changed.

(Inherited from BindingManagerBase)

Применяется к

Дополнительно