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" );
      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." );
      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");
      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.");
       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")
       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.")
       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. 型になります (オブジェクトの一覧) ではなく 1 つのプロパティのみを返すことができるオブジェクトの場合は、データ ソース、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. その一方で、データ ソースは、実装するオブジェクト場合、 IListIListSource、または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

ExceptionBindingManagerBase によって処理された場合に発生します。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)