SandcastleBuilder.MRefBuilder

This represents binding redirection settings for the .

Constructor

This returns a string representation of the item

The item value as a string

This is used to determine whether or not this entry is a redirect for the given strong name

The strong name to compare True if it is a redirect for the strong name, false if not

Create a binding redirect settings instance from an XPath navigator containing the settings.

The XPath navigator from which to obtain the settings. An optional namespace resolver. Pass null if one is not needed. The namespace to prefix the elements with if needed. This is ignored if resolver is null. A object containing the settings from the XPath navigator. It should contain an element called dependentAssembly with a configFile attribute or a nested assemblyIdentity and bindingRedirect element that define the settings.

Load assembly binding redirects from a configuration file.

The configuration filename A collection containing the assembly binding redirects

This is used to get or set the assembly name (no extension)

This is used to get or set the public key token for the assembly

If omitted, "null" is assumed

This is used to get or set the culture for the assembly

If omitted, "neutral" is assumed

This is used to get or set the old version number to redirect to the new version number.

This is used to get or set the ending old version number range to redirect to the new version number.

If not set, only will be used to redirect a single version.

This is used to get or set the new version number to which the old versions are redirected.

This is used to get or set the path to the configuration file from which the settings should be imported.

If specified, the properties in the Binding Redirect category are ignored.

This returns the strong name for the redirect assembly

This is a custom assembly resolver for Sandcastle's MRefBuilder tool that supports assembly binding redirect elements in its configuration that let you redirect an unknown assembly's strong name to another by version number when resolving an unknown reference.

This solves the problem reported in Sandcastle work item #1014. To use the resolver, it must be added to the MRefBuilder.config file by defining the resolver element as shown in the example below. Within the resolver element, add an assemblyBinding element that contains one or more dependentAssembly elements that define the redirections. If you have a set of redirections in an application or web configuration file, you can define a dependentAssembly element with an importFrom attribute that specifies the location of the configuration file from which to import the redirects. The other option is to specify individual redirects using the assemblyIdentity and bindingRedirect child elements of each dependentAssembly element. See the MSDN help for those elements for more information on their usage. The assembly version(s) to which the entries are redirected must be one of the documented assemblies or must be referenced as a dependency using the /dep command line switch. ]]>

Constructor

The configuration navigator

This is overridden to resolve unknown assembly references

The reference to resolve The module The assembly node if resolved or null if not resolved