CurrencyManager Kelas

Definisi

Ruang nama:

System.Windows.Forms

Rakitan:

System.Windows.Forms.dll

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 atau CurrencyManagerPropertyManager. 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 Position properti ke 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

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

Properti

Bindings	Mendapatkan koleksi 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 berada dalam daftar.

Metode

AddNew()	Menambahkan item baru ke daftar dasar.
CancelCurrentEdit()	Membatalkan operasi edit saat ini.
CheckEmpty()	Melemparkan pengecualian jika tidak ada daftar, atau daftar kosong.
EndCurrentEdit()	Mengakhiri operasi edit saat ini.
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetItemProperties()	Mendapatkan koleksi deskriptor properti untuk daftar yang mendasar.
GetItemProperties(ArrayList, ArrayList)	Mendapatkan kumpulan deskriptor properti untuk pengikatan menggunakan yang ditentukan 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.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
OnBindingComplete(BindingCompleteEventArgs)	Memunculkan kejadian BindingComplete. (Diperoleh dari BindingManagerBase)
OnCurrentChanged(EventArgs)	Memunculkan kejadian CurrentChanged.
OnCurrentItemChanged(EventArgs)	Memunculkan kejadian CurrentItemChanged.
OnDataError(Exception)	Memunculkan kejadian DataError. (Diperoleh dari BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Memunculkan kejadian ItemChanged.
OnMetaDataChanged(EventArgs)	Memunculkan kejadian MetaDataChanged.
OnPositionChanged(EventArgs)	Memunculkan kejadian PositionChanged.
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.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
UpdateIsBinding()	Updates status pengikatan.

Acara

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 diam-diam ExceptionBindingManagerBaseditangani 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