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
Наследование
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.

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)

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

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