CurrencyManager Класс

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Комментарии

Является CurrencyManager производным BindingManagerBase от класса . Используйте для BindingContext возврата или CurrencyManagerPropertyManager. Фактический возвращаемый объект зависит от источника данных и элемента данных, передаваемых BindingContextв Item[] свойство объекта . Если источником данных является объект, который может возвращать только одно свойство (вместо списка объектов), типом PropertyManagerбудет . Например, если указать в TextBox качестве источника данных, PropertyManager будет возвращен объект . Если, с другой стороны, источником данных является объект, реализующий IListинтерфейс , IListSourceили 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()	Завершает текущую операцию редактирования.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetItemProperties()	Возвращает коллекцию дескрипторов свойств для базового списка.
GetItemProperties(ArrayList, ArrayList)	Получает коллекцию дескрипторов свойств для привязки с помощью указанного списка ArrayList. (Унаследовано от BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Получает список свойств элементов, управляемых этим объектом BindingManagerBase. (Унаследовано от BindingManagerBase)
GetListName(ArrayList)	Возвращает имя списка, предоставляющего данные для привязки, с использованием заданного набора связанных свойств.
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
MemberwiseClone()	Создает неполную копию текущего объекта Object. (Унаследовано от Object)
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()	Приостанавливает действие привязки данных, чтобы предотвратить обновление привязанного источника данных в результате изменений.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
UpdateIsBinding()	Обновляет состояние привязки.

События

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

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

• BindingsCollection
• BindingContext
• Binding