<publisherPolicy> Element

Specifies whether the runtime applies publisher policy.

<configuration> Element
  <runtime> Element
    <assemblyBinding> Element for <runtime>
      <dependentAssembly> Element
        <publisherPolicy> Element

<publisherPolicy apply="yes|no"/>

Attributes and Elements

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

Attributes

Attribute

Description

apply

Specifies whether to apply publisher policy.

apply Attribute

Value

Description

yes

Applies publisher policy. This is the default setting.

no

Does not apply publisher policy.

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 assembly binding and garbage collection.

Remarks

When a component vendor releases a new version of an assembly, the vendor can include a publisher policy so applications that use the old version now use the new version. To specify whether to apply publisher policy for a particular assembly, put the <publisherPolicy> element in the <dependentAssembly> element.

The default setting for the apply attribute is yes. Setting the apply attribute to no overrides any previous yes settings for an assembly.

Permission is required for an application to explicitly ignore publisher policy using the <publisherPolicy apply="no"/> element in the application configuration file. The permission is granted by setting the BindingRedirects flag on the SecurityPermission Class. For more information, see Assembly Binding Redirection Security Permission.

Example

The following example turns off publisher policy for the assembly, myAssembly.

<configuration>
   <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
            <assemblyIdentity name="myAssembly"
                                    publicKeyToken="32ab4ba45e0a69a1"
                                    culture="neutral" />
            <publisherPolicy apply="no"/>
         </dependentAssembly>
      </assemblyBinding>
   </runtime>
</configuration>

See Also

Reference

Runtime Settings Schema

Concepts

How the Runtime Locates Assemblies

Redirecting Assembly Versions

Other Resources

Configuration File Schema for the .NET Framework