Algumas APIs lançam ArgumentNullException

Algumas APIs agora validam os parâmetros de entrada e geram uma ArgumentNullException, ao passo que antes geravam uma NullReferenceException, se invocadas com argumentos de entrada null.

Descrição da alteração

Nas versões anteriores do .NET, as APIs afetadas lançam um NullReferenceException se invocado com um argumento que é null.

A partir do .NET 6, as APIs afetadas lançam um ArgumentNullException se invocado com um argumento que é null.

Alterar categoria

Essa alteração afeta a compatibilidade binária.

Motivo da alteração

A geração de ArgumentNullException está em conformidade com o comportamento do runtime do .NET. Ele fornece uma melhor experiência de depuração comunicando claramente qual argumento causou a exceção.

Versão introduzida

.NET 6

Ação recomendada

• Examine e, se necessário, atualize seu código para evitar a passagem null de argumentos de entrada para as APIs afetadas.
• Se o seu código lida com NullReferenceException, substitua por um novo manipulador ou adicione um adicional para ArgumentNullException.

APIs afetadas

A tabela a seguir lista as APIs afetadas e os parâmetros específicos:

Método/propriedade	Nome do parâmetro
System.Windows.Forms.TreeNodeCollection.Item[Int32]	index
DrawTreeNodeEventArgs(Graphics, TreeNode, Rectangle, TreeNodeStates)	graphics
DataGridViewRowStateChangedEventArgs(DataGridViewRow, DataGridViewElementStates)	dataGridViewRow
DataGridViewColumnStateChangedEventArgs(DataGridViewColumn, DataGridViewElementStates)	dataGridViewColumn

Consulte também

• O TreeNodeCollection.Item gera uma exceção quando o nó é atribuído em outro lugar