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.NET.chm (410 kB or zipped, 383 kB) contains the documentation created using the Sandcastle Help File Builder. Please browse our on-line version and see the Manual Page.

CryptoSys API Core

To use the .NET class library, you need to download and install a version of the core CryptoSys API DLL, 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

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 20 March 2009