WinForms プロパティによる ArgumentOutOfRangeException のスロー

  • [アーティクル]

一部の Windows フォーム プロパティで、無効な引数に対して 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