Compartilhar via


As propriedades do WinForms agora geram ArgumentOutOfRangeException

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

Descrição da alteração

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

Gerar um ArgumentOutOfRangeException está em conformidade com o comportamento do runtime 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 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