NetLoad Command

Overview

The “NetLoad Command” loads a .NET DLL so that the commands it contains become available
in the application. It is the way to add your own commands, or a plug-in supplied by
somebody else, to a running session.

The command can be started in any of the following ways:

1. Enter “_CmdNetLoad” in the prompt window.
2. Enter its alias “netload” in the prompt window.

Usage

Here is an explanation of how the “NetLoad Command” is typically used:

1. Start the command. The prompt “Enter the path to the DLL file.” is displayed and a
   file dialog offering “*.dll” is opened.

2. Select the DLL. A relative path is resolved against the folder the application was
   started from, not against the current directory of the process.

3. The number of commands that were found in the DLL is reported in the prompt window,
   for example “The DLL was loaded. 3 command(s) added.”. If the DLL cannot be loaded,
   the reason is printed in the prompt window instead.

The commands added this way are available until the application is closed. To load a
plug-in every time the application starts, list it in the configuration file instead.
See “Beaver Config File”.

Notes

• The DLL must be built against the .NET API of the application, and the commands in it
  must be marked with the command attribute. See “API” for how such a DLL is written.
• Loading a DLL that contains no commands succeeds and reports “0 command(s) added.”.
• A DLL cannot be unloaded once it has been loaded. Restart the application instead.

Messages

Command Name

_CmdNetLoad

Alias

netload