CurrencyManager CurrencyManager CurrencyManager CurrencyManager Class

정의

Binding 개체의 목록을 관리합니다.Manages a list of Binding objects.

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
상속

예제

다음 코드 예제에서는 바인딩을 TextBox 컨트롤의 열에 DataTable, 가져옵니다는 CurrencyManager 바인딩에 대 해당 위치를 설정 합니다.The following code example binds a TextBox control to a column in a DataTable, gets the CurrencyManager for the binding, and sets its position.

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 클래스입니다.The CurrencyManager derives from the BindingManagerBase class. 사용 합니다 BindingContext 중 하나를 반환 하는 CurrencyManager 또는 PropertyManager합니다.Use the BindingContext to return either a CurrencyManager or a PropertyManager. 반환 되는 실제 개체 데이터 소스에 따라 다르며 데이터 멤버에 전달 합니다 Item[Object] 의 속성을 BindingContext.The actual object returned depends on the data source and data member passed to the Item[Object] property of the BindingContext. 데이터 원본 개체 (개체 목록) 하는 대신 단일 속성만 반환할 수 있는 경우이 됩니다는 PropertyManager합니다.If the data source is an object that can return only a single property (instead of a list of objects), the type will be a PropertyManager. 예를 들어 지정 하는 경우는 TextBox 데이터 원본으로는 PropertyManager 반환 됩니다.For example, if you specify a TextBox as the data source, a PropertyManager will be returned. 반면에 데이터 원본 개체인 구현 하는 경우는 IList, IListSource, 또는 IBindingList 인터페이스는 CurrencyManager 반환 됩니다.If, on the other hand, the data source is an object that implements the IList, IListSource, or IBindingList interface, a CurrencyManager will be returned.

Current 속성 내부 목록의 현재 항목을 반환 합니다.The Current property returns the current item in the underlying list. 현재 항목을 변경 하려면 설정의 Position 속성을 새 값입니다.To change the current item, set the Position property to a new value. 값 0 보다 커야 하며 값 보다 작아야 합니다 Count 속성입니다.The value must be greater than 0 and must be less than the value of the Count property.

기본 데이터 원본 구현 하는 경우는 IBindingList 인터페이스 및 AllowNew 속성이로 설정 되어 true를 사용할 수는 AddNew 메서드.If the underlying data source implements the IBindingList interface, and the AllowNew property is set to true, you can use the AddNew method.

필드

finalType finalType finalType finalType

목록의 데이터 형식을 지정합니다.Specifies the data type of the list.

listposition listposition listposition listposition

목록에 있는 CurrencyManager의 현재 위치를 지정합니다.Specifies the current position of the CurrencyManager in the list.

onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler onCurrentChangedHandler

CurrentChanged 이벤트의 이벤트 처리기를 지정합니다.Specifies the event handler for the CurrentChanged event.

(Inherited from BindingManagerBase)
onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler onPositionChangedHandler

PositionChanged 이벤트의 이벤트 처리기를 지정합니다.Specifies the event handler for the PositionChanged event.

(Inherited from BindingManagerBase)

속성

Bindings Bindings Bindings Bindings

관리되는 바인딩의 컬렉션을 가져옵니다.Gets the collection of bindings being managed.

(Inherited from BindingManagerBase)
Count Count Count Count

목록의 항목 수를 가져옵니다.Gets the number of items in the list.

Current Current Current Current

목록의 현재 항목을 가져옵니다.Gets the current item in the list.

IsBindingSuspended IsBindingSuspended IsBindingSuspended IsBindingSuspended

바인딩이 보류되었는지 여부를 나타내는 값을 가져옵니다.Gets a value indicating whether binding is suspended.

(Inherited from BindingManagerBase)
List List List List

CurrencyManager의 목록을 가져옵니다.Gets the list for this CurrencyManager.

Position Position Position Position

목록 내에서의 위치를 가져오거나 설정합니다.Gets or sets the position you are at within the list.

메서드

AddNew() AddNew() AddNew() AddNew()

내부 목록에 새 항목을 추가합니다.Adds a new item to the underlying list.

CancelCurrentEdit() CancelCurrentEdit() CancelCurrentEdit() CancelCurrentEdit()

현재 편집 작업을 취소합니다.Cancels the current edit operation.

CheckEmpty() CheckEmpty() CheckEmpty() CheckEmpty()

목록이 없거나 비어 있는 경우 예외를 throw합니다.Throws an exception if there is no list, or the list is empty.

EndCurrentEdit() EndCurrentEdit() EndCurrentEdit() EndCurrentEdit()

지금 하고 있는 편집 작업을 종료합니다.Ends the current edit operation.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

지정한 개체와 현재 개체가 같은지 여부를 확인합니다.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

기본 해시 함수로 작동합니다.Serves as the default hash function.

(Inherited from Object)
GetItemProperties() GetItemProperties() GetItemProperties() GetItemProperties()

기본 목록의 속성 설명자 컬렉션을 가져옵니다.Gets the property descriptor collection for the underlying list.

GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList) GetItemProperties(ArrayList, ArrayList)

지정된 ArrayList를 사용하여 바인딩에 대한 속성 설명자의 컬렉션을 가져옵니다.Gets the collection of property descriptors for the binding using the specified ArrayList.

(Inherited from BindingManagerBase)
GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList) GetItemProperties(Type, Int32, ArrayList, ArrayList)

BindingManagerBase가 관리하는 항목의 속성 목록을 가져옵니다.Gets the list of properties of the items managed by this BindingManagerBase.

(Inherited from BindingManagerBase)
GetListName(ArrayList) GetListName(ArrayList) GetListName(ArrayList) GetListName(ArrayList)

지정한 바인딩된 속성 집합을 사용하여 바인딩에 대한 데이터를 제공하는 목록 이름을 가져옵니다.Gets the name of the list supplying the data for the binding using the specified set of bound properties.

GetType() GetType() GetType() GetType()

현재 인스턴스의 Type을 가져옵니다.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.Creates a shallow copy of the current Object.

(Inherited from Object)
OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs) OnBindingComplete(BindingCompleteEventArgs)

BindingComplete 이벤트를 발생시킵니다.Raises the BindingComplete event.

(Inherited from BindingManagerBase)
OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs) OnCurrentChanged(EventArgs)

CurrentChanged 이벤트를 발생시킵니다.Raises the CurrentChanged event.

OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs) OnCurrentItemChanged(EventArgs)

CurrentItemChanged 이벤트를 발생시킵니다.Raises the CurrentItemChanged event.

OnDataError(Exception) OnDataError(Exception) OnDataError(Exception) OnDataError(Exception)

DataError 이벤트를 발생시킵니다.Raises the DataError event.

(Inherited from BindingManagerBase)
OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs) OnItemChanged(ItemChangedEventArgs)

ItemChanged 이벤트를 발생시킵니다.Raises the ItemChanged event.

OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs) OnMetaDataChanged(EventArgs)

MetaDataChanged 이벤트를 발생시킵니다.Raises the MetaDataChanged event.

OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs) OnPositionChanged(EventArgs)

PositionChanged 이벤트를 발생시킵니다.Raises the PositionChanged event.

PullData() PullData() PullData() PullData()

정보를 반환하지 않고 데이터를 데이터 바인딩된 컨트롤에서 데이터 소스로 끌어옵니다.Pulls data from the data-bound control into the data source, returning no information.

(Inherited from BindingManagerBase)
PushData() PushData() PushData() PushData()

정보를 반환하지 않고 데이터를 데이터 소스에서 데이터 바인딩된 컨트롤로 밀어넣습니다.Pushes data from the data source into the data-bound control, returning no information.

(Inherited from BindingManagerBase)
Refresh() Refresh() Refresh() Refresh()

데이터 바인딩된 목록을 강제로 다시 채웁니다.Forces a repopulation of the data-bound list.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

지정한 인덱스에서 해당 항목을 제거합니다.Removes the item at the specified index.

ResumeBinding() ResumeBinding() ResumeBinding() ResumeBinding()

데이터 바인딩을 다시 시작합니다.Resumes data binding.

SuspendBinding() SuspendBinding() SuspendBinding() SuspendBinding()

데이터 바인딩을 일시 중단하여 바인딩된 데이터 소스가 변경 내용으로 업데이트되지 않도록 합니다.Suspends data binding to prevents changes from updating the bound data source.

ToString() ToString() ToString() ToString()

현재 개체를 나타내는 문자열을 반환합니다.Returns a string that represents the current object.

(Inherited from Object)
UpdateIsBinding() UpdateIsBinding() UpdateIsBinding() UpdateIsBinding()

바인딩 상태를 업데이트합니다.Updates the status of the binding.

이벤트

BindingComplete BindingComplete BindingComplete BindingComplete

데이터 바인딩 작업이 완료되면 발생합니다.Occurs at the completion of a data-binding operation.

(Inherited from BindingManagerBase)
CurrentChanged CurrentChanged CurrentChanged CurrentChanged

현재 바인딩된 항목이 변경되면 발생합니다.Occurs when the currently bound item changes.

(Inherited from BindingManagerBase)
CurrentItemChanged CurrentItemChanged CurrentItemChanged CurrentItemChanged

현재 바인딩된 항목의 상태가 변경되면 발생합니다.Occurs when the state of the currently bound item changes.

(Inherited from BindingManagerBase)
DataError DataError DataError DataError

Exception에서 자동으로 BindingManagerBase이 처리되면 발생합니다.Occurs when an Exception is silently handled by the BindingManagerBase.

(Inherited from BindingManagerBase)
ItemChanged ItemChanged ItemChanged ItemChanged

현재 항목이 변경되면 발생합니다.Occurs when the current item has been altered.

ListChanged ListChanged ListChanged ListChanged

목록 또는 목록의 항목이 변경될 때 발생합니다.Occurs when the list changes or an item in the list changes.

MetaDataChanged MetaDataChanged MetaDataChanged MetaDataChanged

List의 메타데이터가 변경되면 발생합니다.Occurs when the metadata of the List has changed.

PositionChanged PositionChanged PositionChanged PositionChanged

Position 속성 값이 변경된 후에 발생합니다.Occurs after the value of the Position property has changed.

(Inherited from BindingManagerBase)

적용 대상

추가 정보