Developing for .NET Framework

The following are the basic Synergy .NET development steps for desktop and server applications for .NET Framework on Windows x86 or x64. Most of these steps outline Visual Studio procedures, so see Visual Studio documentation for more information.

1. Start by reviewing Synergy .NET Requirements and Synergy DBL Integration Requirements. Then set options for your Visual Studio environment as necessary. For example, you can control the behavior of the Visual Studio code editor and the way IntelliSense works for Synergy DBL files. See Options for Synergy/DE projects for more information.
2. In Visual Studio, create a project for each assembly in your application, and put all the projects for your application in one solution. The following project templates are supported for .NET Framework development:

ASP.NET Server Control Library

Class Library (.NET Framework)

Class Library (.NET Standard)

Console App (.NET Framework)

Empty Project


Synergy Custom Action

Synergy/DE Repository

Unit Test Project (.NET Framework)

WCF Service Library

Windows Forms Application

Windows Forms Control Library

Windows Service

WPF App (.NET Framework)

WPF User Control Library

For example, to create a console application (an application that runs from the command line), open Visual Studio without opening a solution and select File > New Project. Then select Synergy/DE from the Installed Templates area of the Project Dialog, and select Console App (.NET Framework) from the list of Synergy project types. You’ll need to set a few options for the project (name, location, and so forth) in the New Project Dialog; then click OK to create the project.

If you create a project when no solution is open in Visual Studio, a solution is automatically created to contain the project. Then, if this solution is open when you create other projects (e.g., class library projects), those projects will be added to the solution. See Synergy files, projects, and solutions for more information, and note the following:

3. Add DBL code, references to any needed assemblies, and other items to the projects for your application. See Synergy/DE item templates for information on new items you can add to a project, and note the following:
4. Set project properties, which include settings for licensing, deployment, and building/compiling. See Synergy/DE project properties. For information on setting environment variables for a project, see Environment variables and Visual Studio development.
5. Build and debug the solution in Visual Studio using Visual Studio build and debug commands. See Visual Studio documentation for information on build features and the debugger, and see Debugging Synergy .NET Code.

To build, rebuild, or clean an individual project, use Build Only Project, Rebuild Only Project, or Clean Only Project. These commands are available on the Visual Studio Build menu and the context menu that opens when your right-click a project node in Solution Explorer.

6. Deploy your application to machines that meet deployment requirements listed in Synergy .NET Requirements.

ClickOnce Deployment for Synergy .NET


Use ClickOnce only for very simple deployments for Synergy .NET Windows desktop applications. ClickOnce deployment is not supported for traditional Synergy application or .NET Core applications.

ClickOnce is a Microsoft deployment technology that enables you to deploy self-updating, self-contained Windows desktop applications that don’t require administrative access to user systems. Setting up ClickOnce deployment can be as easy as setting properties on the Publish page of Project Designer and then clicking a publish button, but you may need to do more. For example, you may need to specify a Synergy license server.

Synergy .NET supports ClickOnce deployment through the following:

See Microsoft documentation for more information on ClickOnce deployment.


All ClickOnce deployments of Synergy applications should be to systems with Synergy/DE. The development system and target systems must have the same version of synrnt.dll and the same hotfixes, if any have been applied. And if you use the Synergy HTTP document transport API or OpenSSL libraries for Synergy data encryption, the system must have OpenSSL DLLs and either httpslib.dll or synssllib.dll. (See Synergex KnowledgeBase article 100001979 for more information.)

Processor-independent application assemblies are not supported. Synergy applications deployed with ClickOnce must be built for either x86 or x64.

Although it is not supported, you may be able to deploy to a system that does not have Synergy/DE if your application doesn’t use HTTPS (with the Synergy HTTP document transport API), SQL Connection, or encryption (including xfServer). If you attempt this, note the following:

  • The Visual C++ components of Visual Studio must be installed on the development machine.
  • The following must be installed on target machines before deployment with ClickOnce: Visual C++ 2012 Runtime Libraries (x64) and Visual C++ 2012 Runtime Libraries (x86).
  • You must set a Synergy license server for ClickOnce deployment on the Runtime Settings page of the Project Designer. This is required whenever a target machine has not been configured for Synergy licensing.
  • You must set the Publish Status for synrnt.dll to “Include”, rather than “Prerequisite”. (Publish Status can be set in the Application Files dialog, which opens when you click “Application Files” on the Publish page of the Project Designer.)
  • If your application uses syntxt.ism and syntxt.is1, you must add them (Project > Add Existing Item) to the Visual Studio project.