CurrencyManager 클래스

정의

네임스페이스:

System.Windows.Forms

어셈블리:

System.Windows.Forms.dll

Binding 개체의 목록을 관리합니다.

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

상속

Object

BindingManagerBase

CurrencyManager

예제

다음 코드 예제에서는 바인딩 된 TextBox 열에 컨트롤을 DataTable바인딩 합니다 바인딩에 대 한 를 가져오 CurrencyManager 고 해당 위치를 설정 합니다.

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

설명

는 CurrencyManager 클래스에서 BindingManagerBase 파생됩니다. BindingContext 를 사용하여 또는 를 CurrencyManager 반환합니다PropertyManager. 반환되는 실제 개체는 의 속성BindingContext에 전달된 데이터 원본 및 데이터 멤버에 Item[] 따라 달라집니다. 데이터 원본이 개체 목록 대신 단일 속성만 반환할 수 있는 개체인 경우 형식은 입니다 PropertyManager. 예를 들어 를 데이터 원본으로 지정 TextBox 하면 가 PropertyManager 반환됩니다. 반면에 데이터 원본이 , IListSource또는 IBindingList 인터페이스를 IList구현하는 개체이면 가 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()	목록이 없거나 비어 있는 경우 예외를 throw합니다.
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