有一些 Windows Forms 屬性對於無效的引數,現在會擲回 ArgumentOutOfRangeException。這在之前不會發生。
變更描述
先前在傳遞超出範圍引數時,這些屬性會擲回各種例外狀況,例如 NullReferenceException、 IndexOutOfRangeException或 ArgumentException。 自 .NET 5 起,這些屬性現在會在傳遞超出範圍的引數時,擲回 ArgumentOutOfRangeException。
擲回 ArgumentOutOfRangeException 符合 .NET 執行階段的行為。 因為會明確傳達不正確的引數,所以也提升了偵錯的體驗。
導入的版本
.NET 5.0
建議的動作
- 請更新程式碼,避免傳遞不正確引數。
- 如有必要,請在設定屬性時,處理 ArgumentOutOfRangeException。
受影響的 API
下表列出受影響的屬性和參數:
屬性 | 參數名稱 | 新增的版本 |
---|---|---|
ListBox.IntegerCollection.Item[Int32] | index |
5.0 Preview 5 |
TreeNode.ImageIndex | value |
5.0 Preview 6 |
TreeNode.SelectedImageIndex | value |
5.0 Preview 6 |