X++, C# Comparison: Exceptions [AX 2012]

Updated: November 15, 2010

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

There are some similarities but many differences when we compare exception related behavior between X++ and C#.

The try, catch, and throw keywords behave the same in X++ and C#. But the types of exceptions thrown and caught are different for the two languages.


Similarities between X++ and C# regarding their exception features include the following:

  • Both languages have the same try keyword.

  • Both have the same catch keyword.

  • Both enable for a catch statement that does not specify any particular exception. Such a catch statement catches all exceptions that reach it.

  • Both have the same throw keyword.


Exception-related differences between X++ and C# are described in the following table.






Jumps to the first instruction in the associated try block. For more information, see Exception Handling with try and catch Keywords.

The functionality of the retry keyword can be mimicked in C# code, but there is no corresponding keyword.

Only X++ has a retry keyword. C# has no counterpart. For more information, see X++, C# Comparison: Automated Retry After an Exception.


There is no finally keyword in X++.

The finally keyword marks a block of code that follows the try and catch blocks. The finally will be executed regardless of whether any exception is thrown or caught.

Only C# has a finally keyword. X++ has no counterpart.

Specific exceptions

In X++ an exception is an element of the Exception enum, such as:

  • Error

  • Deadlock

  • CodeAccessSecurity

No exception can contain another.

In C# an exception is an instance of the System.Exception base class, or any class that inherits from it. An exception can be contained in the InnerException property of the thrown exception.

In X++ each thrown exception is a value of the Exception enum. For more information, see Exception Enumeration.

Exception message

In X++ the message that is created when an exception is raised is available only in the Infolog, and the message is not directly tied to the exception.

In C# the message is the Message member of the System.Exception object.

In X++ the Global::error method is the mechanism that display exception messages in the Infolog. For more information, see Exception Handling with try and catch Keywords.

Exception conditions

In X++ an error occurs when you call an instance method on an object variable that has not yet had anything assigned to it. However, no exception is raised along with this error. Therefore no catch block can gain control even if the unassigned variable is misused in a try block. In the following code example, the error caused by the code box4.toString(); does not cause control to transfer to any catch block:

DialogBox box4;




info("toString did not error, but expected an error.");


catch (Exception::Error) // No Exception value catches this.


info("Invalid use of box4 gave control to catch, unexpected.");


In C# a System.NullReferenceException is raised when an uninitialized variable is treated as an object reference.

There might be several other differences in the conditions that raise exceptions.

SQL transactions

In X++ when an SQL exception occurs in a ttsBegin - ttsCommit transaction, no catch statement inside the transaction block can process the exception.

In C# a catch block inside an SQL transaction can catch the exception.

For more information about X++ exceptions during SQL transactions, see the following topics:

This section contains two code samples. One sample is written in X++, and the other is in C#. Both samples achieve the same result.

The following X++ features are demonstrated:

  • try keyword.

  • catch keyword.

  • The behavior after an Exception::Error exception occurs.

Cc967369.collapse_all(en-us,AX.60).gifX++ Sample

static void JobRs008a_Exceptions(Args _args)
    str sStrings[4];
    int iIndex = 77;
        info("On purpose, this uses an invalid index for this array: "
            + sStrings[iIndex]);
        warning("This message does not appear in the Infolog,"
            + " it is unreached code.");
    // Next is a catch for some of the values of
    // the X++ Exception enumeration.
    catch (Exception::CodeAccessSecurity)
        info("In catch block for -- Exception::CodeAccessSecurity");
    catch (Exception::Error)
        info("In catch block for -- Exception::Error");
    catch (Exception::Warning)
        info("In catch block for -- Exception::Warning");

        info("This last 'catch' is of an unspecified exception.");
    //    //Global::Warning("'finally' is not an X++ keyword, although it is in C#.");

    info("End of program.");


Here is the actual output from the Infolog window:

Message (18:07:24)
Error executing code: Array index 77 is out of bounds.

Stack trace

(C)\Jobs\JobRs008a_Exceptions - line 8

In catch block for -- Exception::Error
End of program.

Cc967369.collapse_all(en-us,AX.60).gifC# Sample

The following C# program is a rewrite of the previous X++ program.

using System;
public class Pgm_CSharp
    static void Main( string[] args )
        new Pgm_CSharp().Rs008a_CSharp_Exceptions();

    void Rs008a_CSharp_Exceptions()
        //str sStrings[4];
        string[] sStrings = new string[4];

                ("On purpose, this uses an invalid index"
                + " for this array: " + sStrings[77]);
                ("This message does not appear in the Infolog,"
                + " it is unreached code.");

        catch (NullReferenceException exc)
            Console.WriteLine("(e1) In catch block for -- "
                + exc.GetType().ToString() );
        catch (IndexOutOfRangeException exc)
            Console.WriteLine("(e2) In catch block for -- "
                + exc.GetType().ToString() );

        // In C#, System.Exception is the base of all
        // .NET Framework exception classes.
        // No as yet uncaught exception can get beyond
        // this next catch.
        catch (Exception exc)
                ("This last 'catch' is of the abstract"
                + " base type Exception: "
                + exc.GetType().ToString());

        // The preceding catch of System.Exception makes this catch of
        // an unspecified exception redundant and unnecessary.
        //    Console.WriteLine("This last 'catch' is"
        //        + " of an unspecified exception.");

                ("'finally' is not an X++ keyword,"
                + " although it is in C#.");
        Console.WriteLine("End of program.");
} // EOClass


Here is the actual output to the C# console:

(e2) In catch block for -- System.IndexOutOfRangeException
'finally' is not an X++ keyword, although it is in C#.
End of program.

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

Community Additions