Redistributing the .NET Client Library

The .NET Client Library requires the .NET Framework 4.8, and requires using Microsoft Visual Studio 2012 or later, with projects targeted to version 4.8 or higher of the .NET Framework.

All a .NET client needs in order to run are the following DLLs, copied to the same directory the client executable occupies:

  • Streambase.SB.Client.dll

  • StreamBase.SB.Monitor.dll, if your program uses the .NET monitor API.

  • The Microsoft Visual Studio runtime DLLs. You install the Microsoft runtime DLLs the same way for .NET programs as for C++ programs, described in Visual Studio 2015-2022 Redistibution Packages.

  • Also, the client machine must have Microsoft .NET Framework 4.8 or later installed.

You may need to update your existing .NET projects using the StreamBase .NET API their references in their Visual Studio project settings to reflect the current names of the DLLs listed above. Be sure to set the Copy Local property of references to these StreamBase assemblies to True.

If you are writing an installer, arrange for these files and your program files to be installed to the same directory. Setting the Copy Local property to true in your .NET Visual Studio projects helps with this. Your installer can be allowed to run without administrator privileges; you might also have to specify that your installer can be run in per-user mode to avoid requiring administrator privileges.

Note that if the same version of these DLLs is also present in the General Assembly Cache (GAC), they will override the versions you distributed with your application. StreamBase strongly recommends that these DLLs not be installed in the GAC.