ObsoleteState Property

Version: Available or changed with runtime version 10.0.

Marks whether the object will be deprecated.

Applies to

  • Page Action Ref
  • Page Custom Action
  • Page File Upload Action
  • Table
  • Table field
  • Table key
  • Codeunit
  • Enum Type
  • Enum Value
  • Page Action
  • Page Action Group
  • Page Action Separator
  • Page Part
  • Page System Part
  • Page Chart Part
  • Page Group
  • Page Label
  • Query
  • Query Column
  • Query Filter
  • Report
  • Report Data Item
  • Report Column
  • Request Page
  • Xml Port
  • Page Field
  • Page Action Area
  • Page Area
  • Page
  • Page View
  • Profile
  • Interface
  • Control Add In
  • Permission Set
  • Field Group

Property value

Value Available or changed with Description
No runtime version 10.0 Not obsolete. This is the normal/default setting.
Pending runtime version 10.0 Will become obsolete in a future version.

Syntax

ObsoleteState = Pending;

Remarks

By coding against this property, you can use this property as a way to communicate through code to other developers which objects and elements will become obsolete over time and those which are already obsolete, enabling them to adjust their application code accordingly.

Note

For all elements, except for Tables and Table fields, setting ObsoleteState = Removed will throw Compiler Error AL0169 because after an appropriate warning state of Pending, these elements can be deleted.

Note

When developing using Dynamics NAV Development Environment (C/SIDE), you do not get warnings or errors when you compile objects that reference table objects, fields, or keys that are marked as Pending or Removed. ObsoleteState property is only detected by the AL compiler, which will return warnings for references to elements marked as Pending and errors for references to elements marked as Removed.

ObsoleteReason Property
Properties
Upgrade Codeunits
Obsolete Attribute