Position Property

BindingManagerBase.Position Property

When overridden in a derived class, gets or sets the position in the underlying list that controls bound to this data source point to.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public abstract int Position { get; set; }
/** @property */
public abstract int get_Position ()

/** @property */
public abstract void set_Position (int value)

public abstract function get Position () : int

public abstract function set Position (value : int)

Not applicable.

Property Value

A zero-based index that specifies a position in the underlying list.

Use the Position property to iterate through the underlying list maintained by the BindingManagerBase. To go to the first item, set the Position to 0. To go to the end of the list, set the Position to the value of the Count property minus 1.

The PositionChanged event occurs when the Position property value changes.

The following code example shows four methods that set the Position property. The MoveNext method increments the property by 1. The MovePrevious method decrements the property by 1. The MoveFirst method sets the property to 0, and the MoveLast method sets the property to the value of the Count property minus 1.

private void BindingManagerBase_CurrentChanged
(object sender, EventArgs e)
{
   // Print the new value of the current object.
   Console.Write("Current Changed: ");
   Console.WriteLine(((BindingManagerBase)sender).Current);
}

private void MoveNext()
{
   // Increment the Position property value by one.
   myBindingManagerBase.Position += 1;
}

private void MovePrevious()
{
   // Decrement the Position property value by one.
   myBindingManagerBase.Position -= 1;
}

private void MoveFirst()
{
   // Go to the first item in the list.
   myBindingManagerBase.Position = 0;
}

private void MoveLast()
{
   // Go to the last row in the list.
   myBindingManagerBase.Position = 
   myBindingManagerBase.Count - 1;
}
   

private void BindingManagerBase_CurrentChanged(Object sender, EventArgs e)
{
    // Print the new value of the current object.
    Console.Write("Current Changed: ");
    Console.WriteLine(((BindingManagerBase)(sender)).get_Current());
} //BindingManagerBase_CurrentChanged

private void MoveNext()
{
    // Increment the Position property value by one.
    myBindingManagerBase.set_Position(myBindingManagerBase.get_Position()
        + 1);
} //MoveNext

private void MovePrevious()
{
    // Decrement the Position property value by one.
    myBindingManagerBase.set_Position(myBindingManagerBase.get_Position() 
        - 1);
} //MovePrevious

private void MoveFirst()
{
    // Go to the first item in the list.
    myBindingManagerBase.set_Position(0);
} //MoveFirst

private void MoveLast()
{
    // Go to the last row in the list.
    myBindingManagerBase.set_Position(myBindingManagerBase.get_Count() - 1);
} //MoveLast

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

Community Additions

ADD
Show:
© 2016 Microsoft