CurrencyManager Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет списком объектов 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
- Наследование
Примеры
В следующем примере кода элемент управления привязывается 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. |
| OnCurrentItemChanged(EventArgs) |
Вызывает событие CurrentItemChanged. (Унаследовано от BindingManagerBase) |
| 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) |