CurrencyManager クラス

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

ソース:

CurrencyManager.cs

Binding オブジェクトのリストを管理します。

C#

public class CurrencyManager : System.Windows.Forms.BindingManagerBase

継承

Object

BindingManagerBase

CurrencyManager

例

次のコード例では、 TextBox の DataTable列にコントロールをバインドし、バインディングの を CurrencyManager 取得し、その位置を設定します。

C#

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;
 }

注釈

は CurrencyManager クラスから BindingManagerBase 派生します。 または をBindingContext返すには、 をCurrencyManagerPropertyManager使用します。 返される実際のオブジェクトは、 の プロパティBindingContextにItem[]渡されるデータ ソースとデータ メンバーによって異なります。 データ ソースが (オブジェクトのリストではなく) 1 つのプロパティのみを返すことができるオブジェクトの場合、型は になります PropertyManager。 たとえば、 をデータ ソースとして指定 TextBox すると、 PropertyManager が返されます。 一方、データ ソースが、、または IBindingList インターフェイスをIListIListSource実装するオブジェクトである場合は、 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