CurrencyManager

.NET Framework クラス ライブラリ リファレンス

CurrencyManager イベント

パブリック イベント

	名前	説明
	BindingComplete	データ バインディング操作の完了時に発生します。 ( BindingManagerBase から継承されます。)
	CurrentChanged	現在バインドされている項目が変更されると発生します。 ( BindingManagerBase から継承されます。)
	CurrentItemChanged	現在バインドされている項目の状態が変更されたときに発生します。 ( BindingManagerBase から継承されます。)
	DataError	Exception が BindingManagerBase によって処理された場合に発生します。 ( BindingManagerBase から継承されます。)
	ItemChanged	現在の項目が変更されている場合に発生します。
	ListChanged	リストまたはリスト内の項目が変更された場合に発生します。
	MetaDataChanged	List のメタデータが変更された場合に発生します。
	PositionChanged	Position プロパティの値が変更された後に発生します。 ( BindingManagerBase から継承されます。)

参照

関連項目

CurrencyManager クラス
System.Windows.Forms 名前空間
BindingsCollection クラス
BindingContext クラス
Binding クラス

CurrencyManager クラス

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Class CurrencyManager
    Inherits BindingManagerBase

Visual Basic (使用法)

Dim instance As CurrencyManager

C#

public class CurrencyManager : BindingManagerBase

C++

public ref class CurrencyManager : public
 BindingManagerBase

J#

public class CurrencyManager extends BindingManagerBase

JScript

public class CurrencyManager extends
 BindingManagerBase

解説

CurrencyManager は、BindingManagerBase クラスから派生します。CurrencyManager または PropertyManager を返すには、BindingContext を使用します。返される実際のオブジェクトは、BindingContext の Item プロパティに渡されたデータ ソースおよびデータ メンバによって異なります。データ ソースが単一のプロパティだけを返すことができるオブジェクトであり、オブジェクトのリストではない場合、オブジェクトの型は PropertyManager になります。たとえば、データ ソースとして TextBox を指定すると、PropertyManager が返されます。一方、データ ソースが、IList、IListSource、または IBindingList の各インターフェイスを実装している場合は、CurrencyManager が返されます。

Current プロパティは、基になるリストにある現在の項目を返します。現在の項目を変更するには、Position プロパティを新しい値に設定します。この値は、0 より大きい値で、Count プロパティの値より小さい値である必要があります。

基になるデータ ソースで IBindingList インターフェイスを実装し、AllowNew プロパティを true に設定すると、AddNew メソッドを使用できます。

使用例

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

Visual Basic

' 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

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

C++

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

JScript

private var myCurrencyManager : CurrencyManager;

private function BindControl(myTable : 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 = CurrencyManager(this.BindingContext[myTable]);
   // Set the initial Position of the control.
   myCurrencyManager.Position = 0;
}

private function MoveNext(myCurrencyManager
 : CurrencyManager){
   if (myCurrencyManager.Position == myCurrencyManager.Count -
 1){
      MessageBox.Show("You're at end of the records");
   }
   else{
     myCurrencyManager.Position += 1;
   }
}

private function MoveFirst(myCurrencyManager
 : CurrencyManager){
   myCurrencyManager.Position = 0;
}

private function MovePrevious(myCurrencyManager
 : CurrencyManager){
   if(myCurrencyManager.Position == 0) {
      MessageBox.Show("You're at the beginning of the records.");
   }   
   else{
      myCurrencyManager.Position -= 1;
   }
}

private function MoveLast(myCurrencyManager
 : CurrencyManager){
   myCurrencyManager.Position = myCurrencyManager.Count - 1;
}

継承階層

System.Object
   System.Windows.Forms.BindingManagerBase
    System.Windows.Forms.CurrencyManager

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
CurrencyManager メンバ
System.Windows.Forms 名前空間
BindingsCollection クラス
BindingContext クラス
Binding クラス

CurrencyManager フィールド

プロテクト フィールド

	名前	説明
	finalType	リストのデータ型を指定します。
	listposition	リスト内の CurrencyManager の現在位置を指定します。
	onCurrentChangedHandler	CurrentChanged イベントのイベント ハンドラを指定します。 ( BindingManagerBase から継承されます。)
	onPositionChangedHandler	PositionChanged イベントのイベント ハンドラを指定します。 ( BindingManagerBase から継承されます。)

参照

関連項目

CurrencyManager クラス
System.Windows.Forms 名前空間
BindingsCollection クラス
BindingContext クラス
Binding クラス

CurrencyManager プロパティ

パブリック プロパティ

	名前	説明
	Bindings	管理されているバインディングのコレクションを取得します。 ( BindingManagerBase から継承されます。)
	Count	オーバーライドされます。 リスト内の項目数を取得します。
	Current	オーバーライドされます。 リスト内の現在の項目を取得します。
	IsBindingSuspended	バインディングが中断されているかどうかを示す値を取得します。 ( BindingManagerBase から継承されます。)
	Position	オーバーライドされます。 リスト内の現在の位置を取得または設定します。

参照

関連項目

CurrencyManager クラス
System.Windows.Forms 名前空間
BindingsCollection クラス
BindingContext クラス
Binding クラス

CurrencyManager メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddNew	オーバーライドされます。 基になるリストに新しい項目を追加します。
	CancelCurrentEdit	オーバーライドされます。 現在の編集操作をキャンセルします。
	EndCurrentEdit	オーバーライドされます。 現在の編集操作を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetItemProperties	オーバーロードされます。 オーバーライドされます。 データ ソースのプロパティ記述子のコレクションを取得します。
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	Refresh	データ バインド リストを強制的に再作成します。
	RemoveAt	オーバーライドされます。 指定したインデックスにある項目を削除します。
	ResumeBinding	オーバーライドされます。 データ バインディングを再開します。
	SuspendBinding	オーバーライドされます。 データ バインディングに伴う変更によるバインド データ ソースの更新を中断します。
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	CheckEmpty	リストが存在しないか、リストが空である場合に、例外をスローします。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	GetItemProperties	オーバーロードされます。 データ ソースのプロパティ記述子のリストを取得します。 ( BindingManagerBase から継承されます。)
	GetListName	オーバーライドされます。 バインドされたプロパティのセットを指定して、バインディングに関するデータを示すリストの名前を取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)
	OnBindingComplete	BindingComplete イベントを発生させます。 ( BindingManagerBase から継承されます。)
	OnCurrentChanged	オーバーライドされます。
	OnCurrentItemChanged	オーバーライドされます。
	OnDataError	DataError イベントを発生させます。 ( BindingManagerBase から継承されます。)
	OnItemChanged	ItemChanged イベントを発生させます。
	OnMetaDataChanged	MetaDataChanged イベントを発生させます。
	OnPositionChanged	PositionChanged イベントを発生させます。
	PullData	データ バインド コントロールからデータ ソースにデータをプルします。情報は返しません。 ( BindingManagerBase から継承されます。)
	PushData	データ ソースからデータ バインド コントロールにデータをプッシュします。情報は返しません。 ( BindingManagerBase から継承されます。)
	UpdateIsBinding	オーバーライドされます。 バインディングのステータスを更新します。

参照

関連項目

CurrencyManager クラス
System.Windows.Forms 名前空間
BindingsCollection クラス
BindingContext クラス
Binding クラス

CurrencyManager メンバ

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

CurrencyManager データ型で公開されるメンバを以下の表に示します。

プロテクト フィールド

	名前	説明
	finalType	リストのデータ型を指定します。
	listposition	リスト内の CurrencyManager の現在位置を指定します。
	onCurrentChangedHandler	CurrentChanged イベントのイベント ハンドラを指定します。(BindingManagerBase から継承されます。)
	onPositionChangedHandler	PositionChanged イベントのイベント ハンドラを指定します。(BindingManagerBase から継承されます。)

パブリック プロパティ

	名前	説明
	Bindings	管理されているバインディングのコレクションを取得します。(BindingManagerBase から継承されます。)
	Count	オーバーライドされます。 リスト内の項目数を取得します。
	Current	オーバーライドされます。 リスト内の現在の項目を取得します。
	IsBindingSuspended	バインディングが中断されているかどうかを示す値を取得します。(BindingManagerBase から継承されます。)
	Position	オーバーライドされます。 リスト内の現在の位置を取得または設定します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	AddNew	オーバーライドされます。 基になるリストに新しい項目を追加します。
	CancelCurrentEdit	オーバーライドされます。 現在の編集操作をキャンセルします。
	EndCurrentEdit	オーバーライドされます。 現在の編集操作を終了します。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetItemProperties	オーバーロードされます。 オーバーライドされます。 データ ソースのプロパティ記述子のコレクションを取得します。
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	Refresh	データ バインド リストを強制的に再作成します。
	RemoveAt	オーバーライドされます。 指定したインデックスにある項目を削除します。
	ResumeBinding	オーバーライドされます。 データ バインディングを再開します。
	SuspendBinding	オーバーライドされます。 データ バインディングに伴う変更によるバインド データ ソースの更新を中断します。
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	CheckEmpty	リストが存在しないか、リストが空である場合に、例外をスローします。
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	GetItemProperties	オーバーロードされます。 データ ソースのプロパティ記述子のリストを取得します。 (BindingManagerBase から継承されます。)
	GetListName	オーバーライドされます。 バインドされたプロパティのセットを指定して、バインディングに関するデータを示すリストの名前を取得します。
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)
	OnBindingComplete	BindingComplete イベントを発生させます。 (BindingManagerBase から継承されます。)
	OnCurrentChanged	オーバーライドされます。
	OnCurrentItemChanged	オーバーライドされます。
	OnDataError	DataError イベントを発生させます。 (BindingManagerBase から継承されます。)
	OnItemChanged	ItemChanged イベントを発生させます。
	OnMetaDataChanged	MetaDataChanged イベントを発生させます。
	OnPositionChanged	PositionChanged イベントを発生させます。
	PullData	データ バインド コントロールからデータ ソースにデータをプルします。情報は返しません。 (BindingManagerBase から継承されます。)
	PushData	データ ソースからデータ バインド コントロールにデータをプッシュします。情報は返しません。 (BindingManagerBase から継承されます。)
	UpdateIsBinding	オーバーライドされます。 バインディングのステータスを更新します。

パブリック イベント

	名前	説明
	BindingComplete	データ バインディング操作の完了時に発生します。(BindingManagerBase から継承されます。)
	CurrentChanged	現在バインドされている項目が変更されると発生します。(BindingManagerBase から継承されます。)
	CurrentItemChanged	現在バインドされている項目の状態が変更されたときに発生します。(BindingManagerBase から継承されます。)
	DataError	Exception が BindingManagerBase によって処理された場合に発生します。 (BindingManagerBase から継承されます。)
	ItemChanged	現在の項目が変更されている場合に発生します。
	ListChanged	リストまたはリスト内の項目が変更された場合に発生します。
	MetaDataChanged	List のメタデータが変更された場合に発生します。
	PositionChanged	Position プロパティの値が変更された後に発生します。(BindingManagerBase から継承されます。)

参照

関連項目

CurrencyManager クラス
System.Windows.Forms 名前空間
BindingsCollection クラス
BindingContext クラス
Binding クラス