Le proprietà WinForms ora generano ArgumentOutOfRangeException

  • Articolo

Alcune proprietà di Windows Forms generano ora un’eccezione ArgumentOutOfRangeException per argomenti non validi, quando in precedenza non lo facevano.

Descrizione delle modifiche

In precedenza, queste proprietà generavano varie eccezioni, ad esempio NullReferenceException, IndexOutOfRangeException o ArgumentException, quando venivano passati argomenti non compresi nell'intervallo. A partire da .NET 5, ora queste proprietà generano un'eccezione ArgumentOutOfRangeException quando vengono passati argomenti non compresi nell'intervallo.

La generazione di ArgumentOutOfRangeException è conforme al comportamento del runtime .NET. Migliora anche l'esperienza di debug comunicando chiaramente quale argomento non è valido.

Versione introdotta

.NET 5.0

  • Aggiornare il codice per impedire il passaggio di argomenti non validi.
  • Se necessario, gestire un ArgumentOutOfRangeException quando si imposta la proprietà.

API interessate

La tabella seguente elenca le proprietà e i parametri interessati:

Proprietà Nome parametro Versione aggiunta
ListBox.IntegerCollection.Item[Int32] index 5.0 Preview 5
TreeNode.ImageIndex value 5.0 Preview 6
TreeNode.SelectedImageIndex value 5.0 Preview 6