Udostępnij za pośrednictwem


Właściwości WinForms zgłaszają teraz wyjątek ArgumentOutOfRangeException

Niektóre właściwości formularzy systemu Windows zgłaszają teraz argumenty ArgumentOutOfRangeException nieprawidłowe, gdzie wcześniej nie były.

Opis zmiany

Wcześniej te właściwości rzucały różne wyjątki, takie jak NullReferenceException, IndexOutOfRangeExceptionlub ArgumentException, po przekazaniu argumentów poza zakresem. Począwszy od platformy .NET 5, te właściwości zgłaszają ArgumentOutOfRangeException teraz po przekazaniu argumentów, które są poza zakresem.

Zgłaszanie obiektu ArgumentOutOfRangeException jest zgodne z zachowaniem środowiska uruchomieniowego platformy .NET. Poprawia również środowisko debugowania, wyraźnie komunikując, który argument jest nieprawidłowy.

Wprowadzona wersja

.NET 5.0

  • Zaktualizuj kod, aby zapobiec przekazywaniu nieprawidłowych argumentów.
  • W razie potrzeby obsłuż ArgumentOutOfRangeException właściwość podczas ustawiania właściwości.

Dotyczy interfejsów API

Poniższa tabela zawiera listę właściwości i parametrów, których dotyczy problem:

Właściwości Nazwa parametru Dodano wersję
ListBox.IntegerCollection.Item[Int32] index 5.0 (wersja zapoznawcza 5)
TreeNode.ImageIndex value 5.0 (wersja zapoznawcza 6)
TreeNode.SelectedImageIndex value 5.0 (wersja zapoznawcza 6)