Share via


X++ Scenarios that are Not Supported in CIL

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

A small number of X++ items or scenarios are not always supported in the Microsoft .NET Framework common intermediate language (CIL), and should be avoided.

X++ Functions that are Not Supported in CIL

X++ language functions that run strings of dynamically written X++ code are not supported when compiled to CIL. The following X++ functions are not supported when compiled to CIL:

  • evalbuf

  • runbuf

Scenario that is Not Supported by Incremental CIL Generation

You must run a full CIL generation to remove items from the CIL, after you remove them from the Application Object Tree (AOT). The following list gives the details of the scenario:

  • Run a full CIL generation in your Microsoft Dynamics AX system.

    Warning

    When running a full CIL generation, make sure that the operation finishes before opening any additional Microsoft Dynamics AX clients to ensure a successful completion.

  • Use the Application Object Tree (AOT) to remove a method from a class or table.
    The system removes the method from the p-code that X++ is compiled to.

  • Run an incremental CIL generation.

    Warning

    The incremental CIL generation does not remove the method from the CIL. Instead, use a full CIL generation to remove the method from the CIL.

Compile Outcome When a Class has One Bad Method

When a C# class for the .NET Framework is compiled to CIL, a C# syntax error in any method causes the entire compile to fail. In contrast, in X++ a method on a class can run normally even after another method on the same class has been failed by the X++ compiler. The X++ compiler still generates valid p-code for methods that contain no errors.

In Microsoft Dynamics AX, when a full compile of X++ p-code to CIL is performed, the entire compile fails if valid p-code is unavailable for any method on any class.

Important

Until your system has a successful full CIL compile, your system cannot run services, SSRS reports, or batch jobs.

Tip

The Cumulative Update 2 for Microsoft Dynamics AX 2012 includes a change that affects the X++ compiler. When the updated X++ compiler encounters invalid X++ source code, it writes valid p-code that throws an exception at run time. This enables the subsequent compile to CIL to succeed.

The cumulative update can be downloaded from the Customer Source website. The X++ compiler update hotfix is associated with KB2617478, which is part of KB2606916.

See also

X++ Compiled to .NET CIL

Announcements: New book: "Inside Microsoft Dynamics AX 2012 R3" now available. Get your copy at the MS Press Store.