CurrencyManager Класс

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

CurrencyManager.cs

Управляет списком Binding объектов.

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

Наследование

Object

BindingManagerBase

CurrencyManager

Примеры

В следующем примере кода элемент управления привязывается TextBox к столбцу в столбце DataTable, получает CurrencyManager привязку и задает ее положение.

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

Комментарии

Производный CurrencyManagerBindingManagerBase от класса. Используйте для BindingContext возврата либо aCurrencyManager, либо .PropertyManager Фактический возвращаемый объект зависит от источника данных и элемента данных, переданного Item[] свойству объекта BindingContext. Если источник данных является объектом, который может возвращать только одно свойство (вместо списка объектов), тип будет типом PropertyManager. Например, если указать TextBox источник данных в качестве источника данных, PropertyManager будет возвращено значение. Если, с другой стороны, источник данных является объектом, реализующим IListIListSourceинтерфейс или IBindingList интерфейс, CurrencyManager будет возвращен.

Свойство Current возвращает текущий элемент в базовом списке. Чтобы изменить текущий элемент, задайте Position для свойства новое значение. Значение должно быть больше 0 и должно быть меньше значения Count свойства.

Если базовый источник данных реализует IBindingList интерфейс, а AllowNew для свойства задано trueзначение, можно использовать AddNew этот метод.

Поля

Имя	Описание
finalType	Указывает тип данных списка.
listposition	Указывает текущую позицию CurrencyManager списка.
onCurrentChangedHandler	Задает обработчик событий для CurrentChanged события. (Унаследовано от BindingManagerBase)
onPositionChangedHandler	Задает обработчик событий для PositionChanged события. (Унаследовано от BindingManagerBase)

Свойства

Имя	Описание
Bindings	Возвращает коллекцию управляемых привязок. (Унаследовано от BindingManagerBase)
Count	Возвращает количество элементов в списке.
Current	Возвращает текущий элемент в списке.
IsBindingSuspended	Возвращает значение, указывающее, приостановлена ли привязка. (Унаследовано от BindingManagerBase)
List	Возвращает список для этого CurrencyManager.
Position	Возвращает или задает положение, в котором вы находитесь в списке.

Методы

Имя	Описание
AddNew()	Добавляет новый элемент в базовый список.
CancelCurrentEdit()	Отменяет текущую операцию редактирования.
CheckEmpty()	Создает исключение, если нет списка, или список пуст.
EndCurrentEdit()	Завершает текущую операцию редактирования.
GetItemProperties()	Возвращает коллекцию дескрипторов свойств для базового списка.
GetItemProperties(ArrayList, ArrayList)	Возвращает коллекцию дескрипторов свойств для привязки с помощью указанного ArrayList. (Унаследовано от BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Возвращает список свойств элементов, управляемых этим BindingManagerBase. (Унаследовано от BindingManagerBase)
GetListName(ArrayList)	Возвращает имя списка, предоставляющего данные для привязки, с помощью указанного набора привязанных свойств.
OnBindingComplete(BindingCompleteEventArgs)	Вызывает событие BindingComplete. (Унаследовано от BindingManagerBase)
OnCurrentChanged(EventArgs)	Вызывает событие CurrentChanged.
OnCurrentItemChanged(EventArgs)	Вызывает событие CurrentItemChanged.
OnDataError(Exception)	Вызывает событие DataError. (Унаследовано от BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Вызывает событие ItemChanged.
OnMetaDataChanged(EventArgs)	Вызывает событие MetaDataChanged.
OnPositionChanged(EventArgs)	Вызывает событие PositionChanged.
PullData()	Извлекает данные из элемента управления, привязанного к данным, в источник данных, возвращая никаких сведений. (Унаследовано от BindingManagerBase)
PushData()	Отправляет данные из источника данных в элемент управления с привязкой к данным, возвращая никаких сведений. (Унаследовано от BindingManagerBase)
Refresh()	Принудительно выполняет повторное заполнение списка, привязанного к данным.
RemoveAt(Int32)	Удаляет элемент по указанному индексу.
ResumeBinding()	Возобновляет привязку данных.
SuspendBinding()	Приостанавливает привязку данных, чтобы предотвратить обновление связанного источника данных.
UpdateIsBinding()	Обновляет состояние привязки.

События

Имя	Описание
BindingComplete	Происходит при завершении операции привязки данных. (Унаследовано от BindingManagerBase)
CurrentChanged	Происходит при изменении текущего привязанного элемента. (Унаследовано от BindingManagerBase)
CurrentItemChanged	Происходит при изменении состояния привязанного в данный момент элемента. (Унаследовано от BindingManagerBase)
DataError	Происходит, когда Exception автоматически обрабатывается параметром BindingManagerBase. (Унаследовано от BindingManagerBase)
ItemChanged	Происходит при изменении текущего элемента.
ListChanged	Происходит при изменении списка или элемента в списке.
MetaDataChanged	Происходит при изменении метаданных объекта List .
PositionChanged	Происходит после изменения значения Position свойства. (Унаследовано от BindingManagerBase)

См. также раздел

• BindingsCollection
• BindingContext
• Binding