<relativeBindForResources> Element

.NET Framework 4.5

Optimizes the probe for satellite assemblies.

<configuration> Element
  <runtime> Element
    <relativeBindForResources> Element
<relativeBindForResources  
   enabled="true|false" />

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute

Description

enabled

Required attribute.

Specifies whether the common language runtime optimizes the probe for satellite assemblies.

enabled Attribute

Value

Description

false

The runtime does not optimize the probe for satellite assemblies. This is the default value.

true

The runtime optimizes the probe for satellite assemblies.

Child Elements

None.

Parent Elements

Element

Description

configuration

The root element in every configuration file used by the common language runtime and .NET Framework applications.

runtime

Contains information about runtime initialization options.

In general, Resource Manager probes for resources, as documented in the Packaging and Deploying Resources in Desktop Apps topic. This means that when Resource Manager probes for a particular localized version of a resource, it may look in the global assembly cache, look in a culture-specific folder in the application's code base, query Windows Installer for satellite assemblies, and raise the AppDomain.AssemblyResolve event. The <relativeBindForResources> element optimizes the way in which Resource Manager probes for satellite assemblies. It can improve performance when probing for resources under the following conditions:

  • When the satellite assembly is deployed in the same location as the code assembly. In other words, if the code assembly is installed in the global assembly cache, the satellite assemblies must also be installed there. If the code assembly is installed in the application's code base, the satellite assemblies must also be installed in a culture-specific folder in the code base.

  • When Windows Installer is not used or is used only rarely for on-demand installation of satellite assemblies.

  • When application code does not handle the AppDomain.AssemblyResolve event.

Setting the enabled attribute of the <relativeBindForResources> element to true optimizes Resource Manager's probe for satellite assemblies as follows:

  • It uses the location of the parent code assembly to probe for the satellite assembly.

  • It does not query Windows Installer for satellite assemblies.

  • It does not raise the AppDomain.AssemblyResolve event.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft