Ice.Plugin.*

Ice.Plugin.name

Synopsis

Ice.Plugin.name=assembly:class [args]

Description

Defines a C# plug-in to be installed during communicator initialization. The assembly component can be a partially or fully qualified assembly name, or an assembly path name.

The details on how assemblies are load depends on how you define the assembly component:

Value for assembly

Examples

Description

Assembly name

myplugin,Version=...,Culture=neutral,publicKeyToken=...

myplugin

The assembly name can be a fully or partially qualified assembly name. The assembly is loaded using Assembly.Load.

Assembly path name

MyPlugin.dll

plugins\MyPlugin.dll

C:\plugins\MyPlugin.dll

The path name can be an absolute path name or a path name relative to the application's current working directory. The assembly is loaded using Assembly.LoadFrom.

The specified class must implement the PluginFactory interface. Any arguments that follow the class name are passed to the factory's create method. For example:

CODE

Ice.Plugin.MyPlugin=MyFactory,Version=1.2.3.4:MyFactory arg1 arg2

Whitespace separates the arguments, and any arguments that contain whitespace must be enclosed in quotes.

If you specify a relative path name in the entry point, the assembly is located relative to the program's current working directory:

CODE

Ice.Plugin.MyPlugin=..\MyFactory.dll:MyFactory arg1 arg2

Enclose the assembly's path name in quotes if it contains spaces:

CODE

Ice.Plugin.MyPlugin="C:\Program Files\MyPlugin\MyFactory.dll:MyFactory" arg1 arg2

A full qualified assembly name or a partial qualified assembly name in the plug-in entry point only works when the assembly is listed in the application dependencies file.