WinForms-Eigenschaften lösen nun ArgumentOutOfRangeException aus

  • Artikel

Einige Windows Forms-Eigenschaften lösen nun eine ArgumentOutOfRangeException für ungültige Argumente aus, was zuvor nicht der Fall war.

Änderungsbeschreibung

Zuvor haben diese Eigenschaften verschiedene Ausnahmen ausgelöst, wie z. B. NullReferenceException, IndexOutOfRangeException oder ArgumentException, wenn Argumente außerhalb des zulässigen Bereichs übergeben wurden. Ab .NET 5 lösen diese Eigenschaften stattdessen eine ArgumentOutOfRangeException aus, wenn Argumente außerhalb des zulässigen Bereichs übergeben werden.

Das Auslösen einer ArgumentOutOfRangeException-Ausnahme entspricht dem Verhalten der .NET Runtime. Außerdem wird die Debugfunktion verbessert, indem ausdrücklich kommuniziert wird, welches Argument ungültig ist.

Eingeführt in Version

.NET 5.0

  • Aktualisieren Sie den Code, um das Übergeben ungültiger Argumente zu verhindern.
  • Behandeln Sie ggf. eine ArgumentOutOfRangeException, wenn Sie die Eigenschaft festlegen.

Betroffene APIs

In der folgenden Tabelle sind die betroffenen Eigenschaften und Parameter aufgeführt:

Eigenschaft Parametername Hinzugefügte Version
ListBox.IntegerCollection.Item[Int32] index 5.0 Vorschau 5
TreeNode.ImageIndex value Version 5.0 Vorschau 6
TreeNode.SelectedImageIndex value Version 5.0 Vorschau 6