CurrencyManager Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

Sumber:

CurrencyManager.cs

Mengelola daftar Binding objek.

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

Warisan

Object

BindingManagerBase

CurrencyManager

Contoh

Contoh kode berikut mengikat TextBox kontrol ke kolom dalam DataTable, mendapatkan CurrencyManager untuk pengikatan, dan mengatur posisinya.

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

Keterangan

Berasal CurrencyManager dari BindingManagerBase kelas . BindingContext Gunakan untuk mengembalikan CurrencyManager atau PropertyManager. Objek aktual yang dikembalikan tergantung pada sumber data dan anggota data yang diteruskan ke Item[] properti BindingContext. Jika sumber data adalah objek yang hanya dapat mengembalikan satu properti (bukan daftar objek), jenisnya akan menjadi PropertyManager. Misalnya, jika Anda menentukan TextBox sebagai sumber data, PropertyManager akan dikembalikan. Jika, di sisi lain, sumber data adalah objek yang mengimplementasikan IListantarmuka , , IListSourceatau IBindingList , CurrencyManager akan dikembalikan.

Properti Current mengembalikan item saat ini dalam daftar yang mendasar. Untuk mengubah item saat ini, atur properti ke Position nilai baru. Nilai harus lebih besar dari 0 dan harus kurang dari Count nilai properti.

Jika sumber data yang mendasar IBindingList mengimplementasikan antarmuka, dan AllowNew properti diatur ke true, Anda dapat menggunakan metode .AddNew

Bidang

Nama	Deskripsi
finalType	Menentukan tipe data daftar.
listposition	Menentukan posisi CurrencyManager daftar saat ini.
onCurrentChangedHandler	Menentukan penanganan aktivitas untuk peristiwa tersebut CurrentChanged . (Diperoleh dari BindingManagerBase)
onPositionChangedHandler	Menentukan penanganan aktivitas untuk peristiwa tersebut PositionChanged . (Diperoleh dari BindingManagerBase)

Properti

Nama	Deskripsi
Bindings	Mendapatkan kumpulan pengikatan yang dikelola. (Diperoleh dari BindingManagerBase)
Count	Mendapatkan jumlah item dalam daftar.
Current	Mendapatkan item saat ini dalam daftar.
IsBindingSuspended	Mendapatkan nilai yang menunjukkan apakah pengikatan ditangguhkan. (Diperoleh dari BindingManagerBase)
List	Mendapatkan daftar untuk ini CurrencyManager.
Position	Mendapatkan atau mengatur posisi anda dalam daftar.

Metode

Nama	Deskripsi
AddNew()	Menambahkan item baru ke daftar yang mendasar.
CancelCurrentEdit()	Membatalkan operasi edit saat ini.
CheckEmpty()	Melemparkan pengecualian jika tidak ada daftar, atau daftar kosong.
EndCurrentEdit()	Mengakhiri operasi edit saat ini.
GetItemProperties()	Mendapatkan koleksi deskriptor properti untuk daftar yang mendasar.
GetItemProperties(ArrayList, ArrayList)	Mendapatkan kumpulan deskriptor properti untuk pengikatan menggunakan ArrayList. (Diperoleh dari BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Mendapatkan daftar properti item yang dikelola oleh ini BindingManagerBase. (Diperoleh dari BindingManagerBase)
GetListName(ArrayList)	Mendapatkan nama daftar yang menyediakan data untuk pengikatan menggunakan kumpulan properti terikat yang ditentukan.
OnBindingComplete(BindingCompleteEventArgs)	Menaikkan BindingComplete acara. (Diperoleh dari BindingManagerBase)
OnCurrentChanged(EventArgs)	Menaikkan CurrentChanged acara.
OnCurrentItemChanged(EventArgs)	Menaikkan CurrentItemChanged acara.
OnDataError(Exception)	Menaikkan DataError acara. (Diperoleh dari BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Menaikkan ItemChanged acara.
OnMetaDataChanged(EventArgs)	Menaikkan MetaDataChanged acara.
OnPositionChanged(EventArgs)	Menaikkan PositionChanged acara.
PullData()	Menarik data dari kontrol terikat data ke sumber data, tidak mengembalikan informasi. (Diperoleh dari BindingManagerBase)
PushData()	Mendorong data dari sumber data ke kontrol terikat data, tidak mengembalikan informasi. (Diperoleh dari BindingManagerBase)
Refresh()	Memaksa repopulasi daftar terikat data.
RemoveAt(Int32)	Menghapus item pada indeks yang ditentukan.
ResumeBinding()	Melanjutkan pengikatan data.
SuspendBinding()	Menangguhkan pengikatan data untuk mencegah perubahan memperbarui sumber data terikat.
UpdateIsBinding()	Memperbarui status pengikatan.

Acara

Nama	Deskripsi
BindingComplete	Terjadi pada penyelesaian operasi pengikatan data. (Diperoleh dari BindingManagerBase)
CurrentChanged	Terjadi ketika item yang saat ini terikat berubah. (Diperoleh dari BindingManagerBase)
CurrentItemChanged	Terjadi ketika status item yang saat ini terikat berubah. (Diperoleh dari BindingManagerBase)
DataError	Terjadi ketika Exception diam-diam BindingManagerBaseditangani oleh . (Diperoleh dari BindingManagerBase)
ItemChanged	Terjadi ketika item saat ini telah diubah.
ListChanged	Terjadi ketika daftar berubah atau item dalam daftar berubah.
MetaDataChanged	Terjadi ketika metadata List telah berubah.
PositionChanged	Terjadi setelah nilai Position properti berubah. (Diperoleh dari BindingManagerBase)

Lihat juga

• BindingsCollection
• BindingContext
• Binding