Installing .NET component into Visual Studio

.NET component is contained in CBFSFlt2017Net.dll, located in the subfolders of <CBFS Filter>\dotNET\ folder. CBFSFlt2017Net.dll requires MSVC Runtime DLLs. Please refer to Deployment instructions for details on installing those Runtime DLLs on your system for development and on target systems during deployment.

To install components to Visual Studio Toolbox

  1. Use Main Menu -> Tools -> Choose Toolbox items to open Toolbox Customization dialog
  2. In the dialog that appears activate .NET Framework Components tab
  3. Find CBFSFilter component in the list and check it.
  4. If you don't find the component in the list, use Browse button to find and add the assembly, which contains the component, to the list.
    Assemblies (32-bit and 64-bit) for .NET 4.6 are located in <CBFS Filter>\dotNET\NET_46 folder.
    Assemblies (32-bit and 64-bit) for .NET 4.5.1 are located in <CBFS Filter>\dotNET\NET_451 folder.
    Assemblies (32-bit and 64-bit) for .NET 4.5 are located in <CBFS Filter>\dotNET\NET_45 folder.
    Assemblies (32-bit and 64-bit) for .NET 4.0 are located in <CBFS Filter>\dotNET\NET_40 folder.
    Assemblies (32-bit and 64-bit) for .NET 2.0 are located in <CBFS Filter>\dotNET\NET_20 folder.

Using the components

To use CBFS Filter in your project, you need to include CBFSFlt2017Net.dll to the list of project references. Then add the following line to the source file:

  • C#:
    using CBFS_Filter;
  • VB.NET:
    imports CBFS_Filter;
  • C++:
    #using <CBFSFlt2017Net.dll>

Referencing plastform-specific assemblies from AnyCPU project

To use CBFS Filter in your AnyCPU project, you need to tell the loader, how to find and load the assembly, which matches your architecture. The sample code in C#-based pseudocode is provided below. The code assumes that you have copies of the assembly, stored in "x86" and "x64" subdirectories of your project's directory. Be sure to turn off "Copy local" option for the assembly reference, so that the compiler doesn't make a (wrong) copy of the assembly to the directory with your project assemblies.



[DllImport("kernel32.dll")]
public static extern IntPtr LoadLibrary(string dllToLoad);
        
AppDomain.CurrentDomain.AssemblyResolve += PlatformDepResolve;
...
private static Assembly PlatformDepResolve(object sender, ResolveEventArgs args)
{
	string AsmName = "CBFSFlt2017Net";
	if (args.Name.StartsWith(AsmName))
	{
		string architecture;
		if (Environment.Is64BitOperatingSystem)
			architecture = "x64";
		else
			architecture = "x86";

		string fileName;
		// Load the MSVC DLL
		fileName = Path.Combine(Environment.CurrentDirectory, architecture, "VCRUNTIME140.dll");
		LoadLibrary(fileName);

		// Load the main assembly
		fileName = Path.Combine(Environment.CurrentDirectory, architecture, AsmName + ".dll");
		Assembly assembly = Assembly.LoadFile(fileName);
		if (args.Name == assembly.FullName)
			return assembly;
	}
	return null;
}
Thanks to Tyrone Erasmus for the custom resolver implementation.