CurrencyManager Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

CurrencyManager.cs

Nesne listesini Binding yönetir.

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

Devralma

Object

BindingManagerBase

CurrencyManager

Örnekler

Aşağıdaki kod örneği, bir TextBox denetimi içindeki bir sütuna DataTablebağlar, bağlama için öğesini CurrencyManager alır ve konumunu ayarlar.

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

Açıklamalar

sınıfından CurrencyManagerBindingManagerBase türetilir. veya PropertyManagerdöndürmek CurrencyManager için öğesini BindingContext kullanın. Döndürülen gerçek nesne, veri kaynağına ve özelliğine geçirilen veri üyesine Item[]BindingContextbağlıdır. Veri kaynağı yalnızca tek bir özellik döndürebilen bir nesneyse (nesne listesi yerine), türü olur PropertyManager. Örneğin, veri kaynağı olarak bir TextBox belirtirseniz, bir PropertyManager döndürülür. Öte yandan, veri kaynağı , IListSourceveya IBindingList arabirimini IListuygulayan bir nesneyse, bir CurrencyManager döndürülür.

Current özelliği, temel alınan listedeki geçerli öğeyi döndürür. Geçerli öğeyi değiştirmek için özelliğini yeni bir değere ayarlayın Position . Değer 0'dan büyük olmalı ve özelliğin değerinden Count küçük olmalıdır.

Temel alınan veri kaynağı arabirimini IBindingList uygularsa ve AllowNew özelliği olarak trueayarlanırsa yöntemini kullanabilirsiniz AddNew .

Alanlar

Name	Description
finalType	Listenin veri türünü belirtir.
listposition	öğesinin listedeki geçerli konumunu CurrencyManager belirtir.
onCurrentChangedHandler	Olayın olay işleyicisini CurrentChanged belirtir. (Devralındığı yer: BindingManagerBase)
onPositionChangedHandler	Olayın olay işleyicisini PositionChanged belirtir. (Devralındığı yer: BindingManagerBase)

Özellikler

Name	Description
Bindings	Yönetilen bağlama koleksiyonunu alır. (Devralındığı yer: BindingManagerBase)
Count	Listedeki öğelerin sayısını alır.
Current	Listedeki geçerli öğeyi alır.
IsBindingSuspended	Bağlamanın askıya alınıp alınmadığını belirten bir değer alır. (Devralındığı yer: BindingManagerBase)
List	Bunun CurrencyManagerlistesini alır.
Position	Listede olduğunuz konumu alır veya ayarlar.

Yöntemler

Name	Description
AddNew()	Temel alınan listeye yeni bir öğe ekler.
CancelCurrentEdit()	Geçerli düzenleme işlemini iptal eder.
CheckEmpty()	Liste yoksa veya liste boşsa bir özel durum oluşturur.
EndCurrentEdit()	Geçerli düzenleme işlemini sonlandırır.
GetItemProperties()	Temel alınan liste için özellik tanımlayıcısı koleksiyonunu alır.
GetItemProperties(ArrayList, ArrayList)	Belirtilen ArrayListkullanarak bağlama için özellik tanımlayıcıları koleksiyonunu alır. (Devralındığı yer: BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList)	Bu BindingManagerBasetarafından yönetilen öğelerin özelliklerinin listesini alır. (Devralındığı yer: BindingManagerBase)
GetListName(ArrayList)	Belirtilen ilişkili özellikler kümesini kullanarak bağlama için verileri sağlayan listenin adını alır.
OnBindingComplete(BindingCompleteEventArgs)	Olayı tetikler BindingComplete . (Devralındığı yer: BindingManagerBase)
OnCurrentChanged(EventArgs)	Olayı tetikler CurrentChanged .
OnCurrentItemChanged(EventArgs)	Olayı tetikler CurrentItemChanged .
OnDataError(Exception)	Olayı tetikler DataError . (Devralındığı yer: BindingManagerBase)
OnItemChanged(ItemChangedEventArgs)	Olayı tetikler ItemChanged .
OnMetaDataChanged(EventArgs)	Olayı tetikler MetaDataChanged .
OnPositionChanged(EventArgs)	Olayı tetikler PositionChanged .
PullData()	Veri bağlı denetimden veri kaynağına veri çeker ve hiçbir bilgi döndürmez. (Devralındığı yer: BindingManagerBase)
PushData()	Veri kaynağından veri bağlama denetimine veri göndererek hiçbir bilgi döndürmez. (Devralındığı yer: BindingManagerBase)
Refresh()	Veriye bağlı listenin yeniden doldurmasını zorlar.
RemoveAt(Int32)	Belirtilen dizindeki öğeyi kaldırır.
ResumeBinding()	Veri bağlamayı sürdürür.
SuspendBinding()	Değişikliklerin ilişkili veri kaynağını güncelleştirmesini önlemek için veri bağlamayı askıya alır.
UpdateIsBinding()	Bağlamanın durumunu güncelleştirir.

Ekinlikler

Name	Description
BindingComplete	Veri bağlama işlemi tamamlandığında gerçekleşir. (Devralındığı yer: BindingManagerBase)
CurrentChanged	Şu anda bağlı olan öğe değiştiğinde gerçekleşir. (Devralındığı yer: BindingManagerBase)
CurrentItemChanged	Şu anda bağlı olan öğenin durumu değiştiğinde gerçekleşir. (Devralındığı yer: BindingManagerBase)
DataError	, Exception tarafından BindingManagerBasesessizce işlendiğinde gerçekleşir. (Devralındığı yer: BindingManagerBase)
ItemChanged	Geçerli öğe değiştirildiğinde gerçekleşir.
ListChanged	Liste değiştiğinde veya listedeki bir öğe değiştiğinde gerçekleşir.
MetaDataChanged	meta verileri değiştiğinde List gerçekleşir.
PositionChanged	Özelliğin değeri Position değiştirildikten sonra gerçekleşir. (Devralındığı yer: BindingManagerBase)

Ayrıca bkz.

• BindingsCollection
• BindingContext
• Binding