ChartDirector 6.2 (.NET Edition)
Installing ChartDirector for .NET
ChartDirector for .NET is distributed as a zip file. Windows may block DLLs in downloaded zip files, so before you can use it, please unblock
After unblocking, simply extract the zip file to the directory you want ChartDirector to be located.
The ChartDirector documentation is in the "ChartDirector\doc" subdirectory in compiled HTML (CHM) format. On Windows, you can read CHM documentation by simply double clicking on the CHM file.
Running ChartDirector Sample Programs
ChartDirector for .NET includes a lot of sample programs for various application frameworks. They are designed as tutorials and examples on how to use ChartDirector. It is strongly recommended that you try at least one set of sample programs.
|Application Framework||Location |
|Windows Forms (C# and VB)||ChartDirector\NetWinCharts |
|WPF (C#)||ChartDirector\NetWPFCharts |
|ASP.NET Web Forms (C# and VB)||ChartDirector\NetWebCharts |
|ASP.NET MVC (C#)||ChartDirector\NetMvcCharts |
Installing Controls in Visual Studio Toolbox
ChartDirector comes with six .NET controls:
The following steps can be used to install these controls into the Visual Studio toolbox:
- Open a WPF, Windows Forms or a Web Forms project, and display a Window or a web page in the designer. Visual Studio should automatically fill the toolbox with some controls.
- Add a new tab by right clicking on the toolbox and select "Add Tab". Name the tab "ChartDirector" or any name you preferred.
- Drag the ChartDirector assembly at "ChartDirector\lib\standard\netchartdir.dll" onto the tab. This adds the ChartDirector controls to the tab.
Some Visual Studio versions may pop up a message window to inform you that some controls are added but not active. This is normal, as ChartDirector contains controls for multiple application frameworks, and only controls compatible with the project type will be active.
It is reported that sometimes Visual Studio may install incorrect type of controls. For example, it may install WPF controls when the project type is Windows Forms. If this happens, the following steps can be used to install the correct type of controls:
- Right click on the tab used to contain the controls, and then click "Choose Items".
- For Windows Forms or Web Form controls, select the "Network Framework Components" tab. For WPF controls, select the "WPF Components" tab.
- Click "Browse" and select the ChartDirector assembly "ChartDirector\lib\standard\netchartdir.dll", and click OK.
In addition to the standard ChartDirector assembly, there is a ChartDirector assembly that targets the .NET Framework Client Profile. There are also strong-named editions of these assemblies. Please refer to the section Using ChartDirector in Your Own Programs
You can add controls from more than one ChartDirector assemblies to the toolbox. In this case, it is suggested you add them to different tabs with names for identification.
Installing Visual Studio Integrated Help
The ChartDirector distribution includes documentation in CHM format. The ChartDirector Visual Studio Integrated Help is the same content installed into the Visual Studio help viewer. It provides the following features:
- You can look up ChartDirector classes, methods and sample program in the "Index" tab of Visual Studio help viewer, and also search for them in the help viewer.
- When you highlight a ChartDirector method in the source code and press F1, the help viewer will open the documentation for that method.
To install ChartDirector Visual Studio Integrated Help, please download it from http://www.advsofteng.com/download.html
and follow the installation instructions on the download page.
Using ChartDirector in Your Own Programs
To use ChartDirector in your application, it needs to include the ChartDirector assembly. The ChartDirector assembly comes in four editions for different usage scenarios:
|Assembly Location (in ChartDirector\lib)||Description |
|standard\netchartdir.dll||The ChartDirector assembly for the standard .NET Framework. |
|client_profile\netchartdir_cp.dll||The ChartDirector assembly for the .NET Framework Client Profile. |
|signed\netchartdir.dll||The strong-named edition of the ChartDirector assembly for the standard .NET Framework. |
|signed_client_profile\netchartdir_cp.dll||The strong-named edition of the ChartDirector assembly for the .NET Framework Client Profile. |
Please refer to Microsoft documentation on what is .NET Framework Client Profile and what is a strong-named assembly. The following is a brief summary.
- The .NET Framework Client Profile is a subset of the .NET Framework for client applications. This is to reduce the size of client applications that need to redistribute the .NET Framework. If your application targets the .NET Framework Client Profile, you would need to use the ChartDirector assembly for the .NET Framework Client Profile. Note that Microsoft has discontinued the .NET Framework Client Profile since .NET version 4.5.
- A strong-named assembly is an assembly with a globally unique identification. A common usage of strong-named assembly is for deployment into the Global Assembly Cache (GAC). If your application is strong-named, it must use the strong-named edition of ChartDirector.
The followings are some of the methods to include ChartDirector in your application:
- If you are using Visual Studio for a Windows Forms, WPF or ASP.NET Web Forms project, dragging a ChartDirector control onto a Windows or Web Form will automatically include the ChartDirector assembly that is used to create the controls in the toolbox. See Installing Controls in Visual Studio Toolbox on how to add ChartDirector controls to the toolbox.
- You can manually add a reference to ChartDirector assembly in your project using "Project/Add Reference" or "Website/Add Reference" (depending on the project type), or by right clicking on the project in the Solution Explorer, and select "Add/Reference". In the Reference Manager window, press "Browse" and navigate to the ChartDirector assembly you would like to add (such as "ChartDirector/lib/standard/netchartdir.dll" for the standard ChartDirector assembly), and press "Add" to add it to your project.
Installing the ChartDirector License
If you have purchased a license to use ChartDirector, you should have a license key delivered to you by email or by post.
If your license key is for upgrading an older license, please append the upgrade key to the older license key and use the combined license key.
If your license key is for a ChartDirector Developer License, please install it in your computer as follows:
- Create an ASCII file called "chartdir.lic", and put the license key in it. The file should contain one line, which is the license key.
- Copy the file to both the "[windows]/system32" and "[windows]/SysWoW64" directories. The [windows] refer to the directory where the Windows OS is installed. For most computers, it is "c:\windows". The "[windows]/SysWoW64" directory only exists on 64-bit Windows. You do not need to copy the file to this directory if it does not exists.
If you cannot access the "[windows]" directory, such as if you are installing the license on a remote server for an ASP.NET application, you can also copy the license file to the "bin" subdirectory of the ASP.NET application. If your application is an EXE file, such as a WPF or Windows Forms application, you can put the license file in the same directory as the EXE file.
If your license key is for a ChartDirector Redistribute License, you may apply the key by calling Chart.setLicenseCode
in your application. In this way, the license key will be compiled into the application executable and redistributed with the application, and ChartDirector will run in licensed mode when used by your application.
© 2017 Advanced Software Engineering Limited. All rights reserved.