This plug-in is used to add assembly binding redirection support to the MRefBuilder configuration file. With this in place, it is possible to document assemblies that use binding redirection to reference assemblies of a different version than the ones they were built against.
Configuring the Plug-In
Once added to the project, this plug-in must be configured. The configuration consists of one or more entries that define how to redirect an assembly reference or an application configuration file from which the settings should be imported. A list box at the top of the configuration dialog box lists the current definitions. Click the Add button to the right of the list box to add a new item. The property grid a the bottom of the dialog box is used to edit each entry's settings. Click the Delete button to the right of the list box to delete an entry.
Configuration Item Options
Each entry consists of the following configuration options:
| Option | Description |
|---|---|
| ConfigurationFile | This option allows you to specify a configuration file from which the binding redirection settings are imported. This should be an application or web configuration file (i.e. App.exe.config or Web.config) that contains an assemblyBinding section that defines the dependent assemblies and how they should be redirected. If specifed, all other configuration options are ignored. The value can contain replacement tags to specify the path to the file (i.e. {@ProjectFolder}..\bin\MyApp.exe.config). |
| AssemblyName | The assembly name that will be redirected. Specify only the name of the assembly. Do not include a path or extension. |
| PublicKeyToken | Specify the public key token of the assembly. If left blank, "null" is assumed. |
| Culture | Specify the culture of the assembly. If left blank, "neutral" is assumed. |
| OldVersion | Use this to specify the old version that will be redirected. If the OldVersionTo property is left blank, this will be used as the single version to redirect. This can be a version value from 0.0.0.0 to 65535.65535.65535.65535. |
| OldVersionTo | To redirect a range of assembly versions, enter the starting version number in the OldVersion property and the ending version number in this property. If this property is left blank, only the version specified in OldVersion is redirected. This can be a version value from 0.0.0.0 to 65535.65535.65535.65535. |
| NewVersion | This defines the new assembly version to which the old versions are redirected. |
See Also
