As propriedades do WinForms agora geram ArgumentOutOfRangeException

Algumas propriedades do Windows Forms agora geram uma ArgumentOutOfRangeException para argumentos inválidos, mas antes elas não faziam isso.

Descrição das alterações

Antes, essas propriedades geravam várias exceções, como NullReferenceException, IndexOutOfRangeException ou ArgumentException, quando argumentos fora do intervalo eram passados. Do .NET 5 em diante, essas propriedades agora geram um ArgumentOutOfRangeException quando os argumentos passados estão fora do intervalo.

A geração de uma ArgumentOutOfRangeException está em conformidade com o comportamento do runtime do .NET. Isso também aprimora a experiência de depuração comunicando claramente qual argumento é inválido.

Versão introduzida

.NET 5.0

  • Atualize o código para evitar a passagem de argumentos inválidos.
  • Se necessário, manipule um ArgumentOutOfRangeException ao definir a propriedade.

APIs afetadas

A seguinte tabela lista as propriedades e os parâmetros afetados:

Propriedade Nome do parâmetro Versão adicionada
ListBox.IntegerCollection.Item[Int32] index 5.0 versão prévia 5
TreeNode.ImageIndex value 5.0 versão prévia 6
TreeNode.SelectedImageIndex value 5.0 versão prévia 6