Partilhar via


As propriedades WinForms agora lançam ArgumentOutOfRangeException

Algumas propriedades do Windows Forms agora lançam um ArgumentOutOfRangeException para argumentos inválidos, onde anteriormente não o faziam.

Alterar descrição

Anteriormente, essas propriedades lançavam várias exceções, como NullReferenceException, IndexOutOfRangeExceptionou ArgumentException, quando passados argumentos fora do intervalo. A partir do .NET 5, essas propriedades agora lançam uma exceção ArgumentOutOfRangeException quando argumentos que estão fora do intervalo são passados.

Lançar um ArgumentOutOfRangeException está em conformidade com o comportamento do tempo de execução do .NET. Ele também melhora 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 tabela a seguir lista as propriedades e os parâmetros afetados:

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