Referencing the Assembly and Deployment

The easiest way to reference and deploy DynamicBarcode Creator in your project is by installing the NuGet package from directly within Visual Studio's Package Manager. Alternatively, you can follow the instructions here to reference and deploy the assembly manually.

NOTE: We encourage installing using NuGet, as this is the easiest and least error-prone installation method.

Referencing From NuGet

To install the NuGet Packages, install the packages directly within Visual Studio's Package Manager.

Manual Installation

If installing using NuGet is not an option, you can also install manually. Refer to the DynamicPDF website to download the assemblies manually. DynamicBarcode Creator v2.0 for .NET is installed at "%Program Files%\ceTe Software\DynamicBarcode Creator v2.0 for .NET\bin" on 32-bit computers and "%ProgramFiles(x86)%\ceTe Software\DynamicBarcode Creator v2.0 for .NET\bin" on 64-bit computers by default. There are four assemblies included, one for each of the following .NET Framework versions: 2.0 / 3.x and 4.x.

Assembly Name Project Type Assembly Version Framework Version
ceTe.DynamicBarcode.Creator.20.dll Windows & Web 2.x.x.20 2.0 and 3.x
ceTe.DynamicBarcode.Creator.40.dll Windows & Web 2.x.x.40 4.x
ceTe.DynamicBarcode.Creator.Wpf.30.dll WPF 2.x.x.30 3.x
ceTe.DynamicBarcode.Creator.Wpf.40.dll WPF 2.x.x.40 4.x

Referencing the Assembly

You can reference the DynamicBarcode creator using Visual Studio 2010-2019 by electing the DynamicBarcode Creator control from Visual Studio toolbox, or by selecting the DynamicBarcode control for WPF from Visual Studio toolbox. Note that the MSI installer automatically installs and adds the controls to Visual Studio Toolbox.

Visual Studio .NET 2010 - 2019

To reference the DynamicBarcode assembly from Visual Studio 2010 - 2019, open your project's references window (right click on the project's References and select "Add Reference..."). Then, from the Add Reference window, select the "Browse" tab and browse to the bin folder where the DLLs are installed. Select the appropriate dll based on the .NET Framework version your project targets.

32-bit (x86) and 64-bit (x64) Versions

All ceTe.DynamicBarcode.Creator dll files are built using the AnyCPU option and therefore do not require separate 32-bit or 64 bit builds. These dll files can run natively in both 32-bit or 64-bit environments.

Adding assembly reference by selecting the DynamicBarcode Creator control from Visual Studio toolbox

The DynamicBarcode Creator MSI automatically adds the DynamicBarcode Creator control to the toolbox of all Visual Studio instances selected during installation. Note that if the toolbox does not contain the DynamicBarcode Creator control, refer the DynamicBarcode Creator as a Control topic for adding it manually. After successful installation of the control, Visual Studio toolbox will contain one or more DynamicBarcode Creator controls inside its toolbox depending on the project's .NET version.

Adding assembly reference by selecting the DynamicBarcode Creator WPF control from Visual Studio toolbox

The DynamicBarcode Creator MSI automatically adds the DynamicBarcode Creator WPF control to the toolbox of all Visual Studio selected for integration during installation. If the toolbox does not contain the DynamicBarcode Creator WPF control, then refer to the DynamicBarcode Creator as a Control topic for information on how to add the control manually. After adding the control, the Visual Studio toolbox will contain one or more DynamicBarcode Creator WPF controls inside its toolbox depending on the .NET version of the project.

Visual Studio .NET 2010 - 2019

There are two different tabs inside the Visual Studio toolbox that contain the DynamicBarcode Creator control and WPF control for the respective framework.

NOTE: Visual Studio filters unsupported framework controls to reflect the current project’s .Net framework. If the current project’s .NET framework is .NET 2.0 or 3.0 or 3.5, then the “DynamicBarcode Creator for .NET 4.x” or “DynamicBarcode Creator for WPF 4.x” tab and its control is absent from the toolbox.

DynamicBarcode Creator for .NET DynamicBarcode Creator for .NET
Figure 1 – Visual Studio integration of DynamicBarcode Creator for WinForm and Web Figure 2 – Visual Studio integration of DynamicBarcode Creator for WPF

NOTE: A compiler error is raised if you add multiple DynamicBarcode Creator controls of different .NET framework inside one or more forms in the same project . Attempts to add multiple references of DynamicBarcode Creator assembly to a project raises a compiler error.

Deployment

When deploying your application, ensure that you add the assembly to your application's bin folder. The folder, DynamicBarcode Creator for .NET, is contained in ceTe's Barcoding assembly (ceTe.DynamicBarcode.Creator.xx.dll). You can then deploy the assembly along with your application using XCOPY or your own setup program.

Licensing

After deploying the dll files with your application you will have a fully functional evaluation edition of DynamicBarcode Creator. However, the evaluation adds a watermark to all barcodes created. To remove the watermark, after purchasing DynamicBarcode Creator, you must add a license key to remove the watermark. A license key can be added by either adding it to a .config file or by adding it programmatically within your application. License keys can be retrieved from the Customer Area of our website, https://www.dynamicpdf.com/CustomerArea after purchasing an appropriate serial number.

In this topic