Developing for Dynamics GP

by David Musgrave (Perth, Australia) and Microsoft Dynamics GP Developer Support Team (Fargo, ND, USA)

How to read your own config file with a VSTools Application

How to read your own config file with a VSTools Application

  • Comments 3

Dave DueskThis article is a result of a couple of recent support incidents where developers would like to read a config from from a Visual Studio Tools (VSTools) addin. VSTools is a special situation because for one, it is a dll, not an exe, and second it only runs if GP is running. VSTools can automatically access the dynamics.exe.config file, steps on how to do that are outlined in KB Article 933930 Secure Link.  The KB is for 9.0 and references the Dynamics.config file, but it also works for the Dynamics.exe.config on 10.0.

In this case, we don't want to use the dynamics.exe.config, we want to use our own config file. Since we are working with a dll, there is no automatic reading from config files like with an exe. Obviously, there is more than one way to handle this and there may be a better way.  This is just one way, that I know works, and it's not too difficult.

This article shows a method to use xml to read the data from a config file. The main VSTools project is called DynamicsGPAddin.dll.  

  1. The config file is named DynamicsGPAddin.dll.config and is deployed to the Addins folder in the main Microsoft Dynamics GP directory.  The config file contains the following information.  You can define this however you want, this just a sample config file.   
    <?xml version="1.0" encoding="utf-8" ?>
        <supportedRuntime version="v1.1.4444"/>
        <requiredRuntime version="v1.0.9999"/>

  2. The name of the VSTools application is DynamicsGPAddin.dll and contains a form with a button and two text fields.  The button reads the config file and displays the data on the window fields.  In order for the code to execute, references to the following must be marked. 
  3. The button code is as follows:
C# Code Example 

MBS Dev Support 

// Copyright © Microsoft Corporation.  All Rights Reserved.
// This code released under the terms of the
// Microsoft Public License (MS-PL,

  • Posting from Jivtesh Singh

  • I realize it's silly to post to an article from 4 years ago, but I'm wondering why even in today's Visual Studio® Tools for Microsoft Dynamics® GP 2010 Programmer’s Guide there is no mention of this issue.  I wasted enough time before I managed to find this article, and I'm sure it might be of help to others new to using this tool for GP development.

    Thanks, Dave.

  • From a .NET perspective, this is just a dll.  A dll (any - not just a GP addin assembly) does not have "automatic configuration file support" like an exe would so this kind of problem isn't specific to a vstools addin.  

    Also Dave points out a KB KB I wrote years ago  - because we _are_ running from an exec (Dynamics.exe) you could add your entries in the dynamics.exe.config file and then your settings would "just work" as if you assembly was executing as an exe.

    But all that said, I'm sure it wouldn't hurt to have something in the documentation that references either option.

Page 1 of 1 (3 items)
Comments Information


Please only post comments relating to the topic of this page.

If you wish to ask a technical question, please use the links in the links section (scroll down, on right hand side) to ask on the Newsgroups or Forums. If you ask on the Newsgroups or Forums, others in the community can respond and the answers are available for everyone in the future.

Leave a Comment
  • Please add 6 and 3 and type the answer here:
  • Post