How to: Call Business Logic Using .NET Business Connector

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

Using .NET Business Connector, you can access Microsoft Dynamics AX data or business logic from a .NET-connected application. This example shows how to use.NET Business Connector to call the Microsoft Dynamics AX class static method. For a complete working example, see Walkthrough: Integrate an Application with Microsoft Dynamics AX Using .NET Business Connector.


Aa851743.collapse_all(en-us,AX.60).gifAdding a Reference to .NET Business Connector

This example assumes that you have a project in which you want to access Microsoft Dynamics AX data. You must create a connection using .NET Business Connector. In this section, you will add a reference to the .NET Business Connector assembly.

To add a reference to .NET Business Connector

  1. In Solution Explorer, right-click References, and then click Add Reference.

  2. In the Add Reference window, click the Browse tab.

  3. Specify the location of Microsoft.Dynamics.BusinessConnectorNet.dll, and then click Add.


    For a typical install, the assembly is located at C:\Program Files (x86)\Microsoft Dynamics AX\60\Client\Bin\.

  4. Click OK.

To set the project target framework

  1. In Solution Explorer, right-click your application project, and then click Properties.

  2. In the Application tab, set the Target framework to .NET Framework 4.

To update the application configuration settings

  1. In Solution Explorer, double-click the app.config file and update the following configuration settings.

    <startup useLegacyV2RuntimeActivationPolicy=”true”>
    <supportedRuntime version “v4.0” />
  2. On the File menu, click Save app.config.


    When you build your project, the development environment automatically creates a copy of your app.config file, changes its file name so that it has the same file name as your executable, and then moves the new .config file in the bin directory.

    If you do not update the app.config file, you will get the following error:

    “Mixed mode assembly is built against version 'v2.0.50727' of the runtime and cannot be loaded in the 4.0 runtime without additional configuration information.”

Aa851743.collapse_all(en-us,AX.60).gifAdding Code to Call a Method

In this section, you will add code to call a Microsoft Dynamics AX method. This example calls the static labelId2String2 method of the SysLabel class.

To add code to call a method

  • Add the following code.

    using System;
    using Microsoft.Dynamics.BusinessConnectorNet;
    namespace BCNetSample1
        /// <summary>
        /// This sample uses the .NET Business Connector to 
        /// call a Microsoft Dynamics AX class static method.
        /// </summary>
        class Class1
            static void Main(string[] args)
                // Create the .NET Business Connector objects.
                Axapta ax;
                string sID = "@SYS21669";
                object o;
                bool b;
                    // Login to Microsoft Dynamics Ax.
                    ax = new Axapta();
                    ax.Logon(null, null, null, null);
                catch (Exception e)
                    Console.WriteLine("An error occurred in object creation 
                        or Axapta logon: {0}", e.Message);
                // Logon was successful.
                    // Call a static class method.
                    // In this example, call SysLabel::labelId2String2 
                    // to determine the label string for a particular label ID.
                    o = ax.CallStaticClassMethod("SysLabel", 
                        "labelId2String2", sID);
                catch (Exception e)
                    Console.WriteLine("An error has been encountered during 
                        CallStaticClassMethod: {0}", e.Message);
                    b = ax.Logoff();
                // Display the returned string.
                Console.WriteLine("The label string for {0} is {1}.", 
                    sID, o.ToString());
                Console.WriteLine("Press any key to continue.");
                // Log off from Microsoft Dynamics AX.
                b = ax.Logoff();


    The console window will open with the following text:

    The label string for @SYS21669 is ABC.

    Press any key to continue.

You can also create, read, update, and delete Microsoft Dynamics AX data. For more information, see How to: Create Data Using .NET Business Connector, How to: Read Data Using .NET Business Connector, How to: Update Data Using .NET Business Connector, and How to: Delete Data Using .NET Business Connector.

See also

Walkthrough: Integrate an Application with Microsoft Dynamics AX Using .NET Business Connector

How to: Debug X++ Code Running in .NET Business Connector

How to: Create Data Using .NET Business Connector



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