Les propriétés WinForms lèvent désormais ArgumentOutOfRangeException

  • Article

Certaines propriétés Windows Forms lèvent désormais ArgumentOutOfRangeException pour les arguments non valides, alors qu’elles ne le faisaient pas précédemment.

Description de la modification

Auparavant, ces propriétés levaient diverses exceptions, telles que NullReferenceException, IndexOutOfRangeException ou ArgumentException, lorsqu’elles transmettaient des arguments hors plage. À partir de .NET 5, ces propriétés lèvent maintenant un ArgumentOutOfRangeException lorsqu’elle transmettent des arguments hors plage.

Lève ArgumentOutOfRangeException conforme au comportement du runtime .NET. Cela améliore également l’expérience de débogage en communiquant clairement quel argument n’est pas valide.

Version introduite

.NET 5.0

  • Mettez à jour le code pour empêcher la transmission d’arguments non valides.
  • Si nécessaire, gérez ArgumentOutOfRangeException lors de la définition de la propriété.

API affectées

Le tableau suivant répertorie les propriétés et paramètres affectés :

Propriété Nom du paramètre Version ajoutée
ListBox.IntegerCollection.Item[Int32] index 5.0 Préversion 5
TreeNode.ImageIndex value 5.0 Préversion 6
TreeNode.SelectedImageIndex value 5.0 Préversion 6