Debug your plugins during development

imranakram edited this page Dec 27, 2017 · 8 revisions

To make debugging from Visual Studio possible, a few things must be configured correctly.

Project Settings

Build Events

Add a Post-build event to create a Plugins sub-folder where XrmToolBox looks for plugin assemblies.

Project Post-build event

Sample post-build event:

if $(ConfigurationName) == Debug (
  IF NOT EXIST Plugins mkdir Plugins
  move /Y MyLittleCompany.*.dll Plugins
  move /Y MyLittleCompany.*.pdb Plugins


Define external program to start for debugging.

Project Debug program

Sample path:


Command line arguments used to specify the current working folder for XrmToolBox:


Recommended Debug Configuration

Argument Description
/overridepath:. This specifies that you want to use the build folder as the root folder for XrmToolBox and not the user's AppData.
/connection:"[Connection Name]" The organization that XrmToolBox should connect to when it starts.
/plugin:"[Plugin Name]" The name of the plugin you are developing. This is the value in ExportMetaData attribute.

Project configuration file

As expected versions of some dependencies might be different between your own plugin and XrmToolBox itself, and to automatically enable connection logging, the sample XrmToolBox.exe.config file from the XrmToolBox NuGet package should be added to the project.

Add configuration file

Right-click the project, select Add - Existing item...

Add XrmToolBox.exe.config

Browse to the packages folder under your solution, and latest version folder for the XrmToolBox package.

To make sure the configuration file is available run-time, go to properties for the file and set Copy to Output Directory = Copy always.

XrmToolBox.exe.config properties

Update configuration file

Some dependencies might not be specified in the sample configuration file. Copy missing dependentAssembly blocks from the app.config file in the project and paste these blocks into the added configuration file.

Add dependentAssemblies

In this case, Microsoft.Xrm.Tooling.Connector and NuGet.Core were needed.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.