Skip to content

Latest commit

 

History

History
34 lines (21 loc) · 1.55 KB

tablelayoutsettings-apis-throw-invalidenumargumentexception.md

File metadata and controls

34 lines (21 loc) · 1.55 KB
Raw
title description ms.date
Breaking change: Some TableLayoutSettings properties throw InvalidEnumArgumentException
Learn about the breaking change in .NET 6 where some TableLayoutSettings APIs now throw an InvalidEnumArgumentException for invalid arguments.
01/18/2021

Selected TableLayoutSettings properties throw InvalidEnumArgumentException

Selected xref:System.Windows.Forms.TableLayoutSettings properties now throw an xref:System.ComponentModel.InvalidEnumArgumentException if you attempt to assign an incorrect value.

Change description

In previous .NET versions, these properties throw an xref:System.ArgumentOutOfRangeException if you attempt to assign an incorrect value. Starting in .NET 6, these properties throw an xref:System.ComponentModel.InvalidEnumArgumentException in such cases.

Change category

This change affects binary compatibility.

Reason for change

Throwing xref:System.ComponentModel.InvalidEnumArgumentException is in line with the existing Windows Forms API in similar situations. Throwing this exception also provides developers with a better debug experience.

Version introduced

.NET 6

Recommended action

  • Update the code to prevent assigning incorrect values.
  • If necessary, handle an xref:System.ComponentModel.InvalidEnumArgumentException when accessing these APIs.

Affected APIs

  • xref:System.Windows.Forms.TableLayoutPanel.CellBorderStyle?displayProperty=fullName
  • xref:System.Windows.Forms.TableLayoutPanel.GrowStyle?displayProperty=fullName