CryptoSys API .NET Class Library Interface

A class library DLL is a cleaner, simpler interface for programmers in all .NET languages including C# and VB.NET. Our class library diCrSysAPINet.dll provides an interface for .NET programmers to the CryptoSys API. Just add a reference to this library file in your project, use the CryptoSysAPI namespace and you are away.

The C# source code for the class library is available so you can change or add to it if you want. If you want to link statically instead in your C# project, then just include the CryptoSysAPI.cs module from the source code in your project and don't bother adding any references to the class library.

How to use

Make sure CryptoSys API is installed on your system.
Copy the dotnet diCrSysAPINet.dll library file into a convenient folder (Hint: the original is included in the main installation for all versions and should be in the folder C:\Program Files\CryptoSys\DotNet unless you installed it in a different directory).
In your application, add a reference to the library:
1. Project > Add Reference.
2. In the .NET tab, click on the Browse button to find and select the library file diCrSysAPINet.dll.
3. Click on OK and the wizard will add the reference of the API library to your project.
Add the line (for C#)
```
using CryptoSysAPI;
```
or (for VB.NET)
```
Imports CryptoSysAPI
```
to your code.

Use the API methods at will, e.g. in C#

using CryptoSysAPI;
int n = General.Version();
Console.WriteLine("Version = {0}", n);

or in VB.NET

Imports CryptoSysAPI
Dim n As Integer
n = General.Version()
Console.WriteLine("Version = {0}", n)

See the example test code provided in the distribution download for both C# and VB.NET.

Help Documentation

CryptoSysAPI.chm (548 kB or zipped, 525 kB) contains the Sandcastle help documention, or browse the on-line version
[Update: 2008-07-28: the on-line version has been recompiled under the newer SHFB version 1.7 and now no longer hangs with Firefox 3.0].

Sadly, the Ndoc program is no more, at least for .NET version 2.0 and above. Belated thanks to Kevin Downs for his excellent work. We're sorry to hear he had such hassles. It does concern us that MS can make such radically different changes between versions of .NET that a program like Ndoc just won't work; you'd almost think they were trying to lock us in, wouldn't you? Anyway, we've used Eric Woodruff's Sandcastle Help File Builder for the latest version. Complain to him about the size of the new file.

CryptoSys API Core

To use the .NET class library, you need to download and install a version of the core CryptoSys API DLL version 3.2 or later, unless you already have a copy installed.

Structure

Your          (References)                     (Calls)
.NET project  -------------> diCrSysAPINet.dll --------> diCryptoSys.dll
                             [class library]            [Core Win32 DLL]
using CryptoSysAPI;
OR                 
Imports CryptoSysAPI

References

Mahesh Chand, Tutorial: Creating C# Class Library (DLL) Using Visual Studio .NET, <http://www.c-sharpcorner.com/2/pr12.asp>.
Francesco Balena and Giuseppe Dimauro, Practical Guidelines and Best Practices for Microsoft Visual Basic and Visual C# Developers, Microsoft Press, 2005, ISBN 0735621721.
Alex Lowe, C# to VB.NET Translation tool, <http://authors.aspalliance.com/aldotnet/examples/translate.aspx>.

This page last updated 28 July 2008