BindingManagerBase.Position-Eigenschaft

Ruft beim Überschreiben in einer abgeleiteten Klasse die Position in der zugrunde liegenden Liste ab, auf die an diese Datenquelle gebundene Steuerelemente zeigen, oder legt diese fest.

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

Syntax

'Declaration
Public MustOverride Property Position As Integer
'Usage
Dim instance As BindingManagerBase
Dim value As Integer

value = instance.Position

instance.Position = value

public abstract int Position { get; set; }

public:
virtual property int Position {
    int get () abstract;
    void set (int value) abstract;
}

/** @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)

Eigenschaftenwert

Ein nullbasierter Index, der eine Position in der zugrunde liegenden Liste angibt.

Hinweise

Durchlaufen Sie die zugrunde liegende, von der BindingManagerBase verwaltete Liste mithilfe der Position-Eigenschaft. Wenn Sie zum ersten Element wechseln möchten, legen Sie Position auf 0 (null) fest. Wenn Sie zum Ende der Liste gehen möchten, legen Sie die Position auf den Wert der Count-Eigenschaft minus 1 fest.

Das PositionChanged-Ereignis tritt ein, wenn sich der Wert der Position-Eigenschaft ändert.

Beispiel

Im folgenden Codebeispiel werden vier Methoden veranschaulicht, mit denen die Position-Eigenschaft festgelegt wird. Durch die MoveNext-Methode wird die Eigenschaft um 1 inkrementiert. Durch die MovePrevious-Methode wird die Eigenschaft um 1 dekrementiert. Durch die MoveFirst-Methode wird die Eigenschaft auf 0 (null) festgelegt. Durch die MoveLast-Methode wird die Eigenschaft auf den Wert der Count-Eigenschaft minus 1 festgelegt.

Private Sub BindingManagerBase_CurrentChanged(sender As Object, e As EventArgs)
    ' Print the new value of the current object.
    Console.Write("Current Changed: ")
    Console.WriteLine(CType(sender, BindingManagerBase).Current)
End Sub 'BindingManagerBase_CurrentChanged


Private Sub MoveNext()
    ' Increment the Position property value by one.
    myBindingManagerBase.Position += 1
End Sub 'MoveNext


Private Sub MovePrevious()
    ' Decrement the Position property value by one.
    myBindingManagerBase.Position -= 1
End Sub 'MovePrevious


Private Sub MoveFirst()
    ' Go to the first item in the list.
    myBindingManagerBase.Position = 0
End Sub 'MoveFirst


Private Sub MoveLast()
    ' Go to the last row in the list.
    myBindingManagerBase.Position = myBindingManagerBase.Count - 1
End Sub 'MoveLast

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) )->Current );
   }

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

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

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

   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

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

BindingManagerBase-Klasse
BindingManagerBase-Member
System.Windows.Forms-Namespace
PositionChanged
BindingManagerBase.Current-Eigenschaft
BindingManagerBase.Count-Eigenschaft