<bindingRedirect> elemento<bindingRedirect> Element

Reindirizza una versione dell'assembly in un'altra.Redirects one assembly version to another.

<configuration><configuration>
<runtime><runtime>
<assemblyBinding ><assemblyBinding>
<dependentAssembly ><dependentAssembly>
<bindingRedirect ><bindingRedirect>

SintassiSyntax

   <bindingRedirect    
oldVersion="existing assembly version"  
newVersion="new assembly version"/>  

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
oldVersion Attributo obbligatorio.Required attribute.

Specifica la versione dell'assembly richiesta in origine.Specifies the version of the assembly that was originally requested. Il formato di un numero di versione di assembly è revisione.The format of an assembly version number is major.minor.build.revision. I valori validi per ogni parte del numero di versione sono compresi tra 0 e 65535.Valid values for each part of this version number are 0 to 65535.

È inoltre possibile specificare una gamma di versioni nel seguente formato:You can also specify a range of versions in the following format:

n.n.n. n - n.n.n. nn.n.n.n - n.n.n.n
newVersion Attributo obbligatorio.Required attribute.

Specifica la versione dell'assembly da usare invece la versione richiesta originariamente nel formato: n.n.n. nSpecifies the version of the assembly to use instead of the originally requested version in the format: n.n.n.n

Questo valore può specificare una versione precedente di oldVersion.This value can specify an earlier version than oldVersion.

Elementi figlioChild Elements

ElementoElement DescrizioneDescription
NessunoNone

Elementi padreParent Elements

ElementoElement DescrizioneDescription
assemblyBinding Contiene le informazioni sul reindirizzamento della versione degli assembly e i relativi percorsi.Contains information about assembly version redirection and the locations of assemblies.
configuration Elemento radice in ciascun file di configurazione usato in Common Language Runtime e nelle applicazioni .NET Framework.The root element in every configuration file used by the common language runtime and .NET Framework applications.
dependentAssembly Incapsula i criteri di associazione e il percorso dell'assembly per ciascun assembly.Encapsulates binding policy and assembly location for each assembly. Utilizzare un elemento dependentAssembly per ciascun assembly.Use one dependentAssembly element for each assembly.
runtime Contiene informazioni sull'associazione degli assembly e sull'operazione di Garbage Collection.Contains information about assembly binding and garbage collection.

NoteRemarks

Quando si compila un'applicazione .NET Framework in base a un assembly con un nome sicuro, per impostazione predefinita tale versione dell'assembly viene utilizzata dall'applicazione in fase di esecuzione, anche se è disponibile una nuova versione.When you build a .NET Framework application against a strong-named assembly, the application uses that version of the assembly at run time by default, even if a new version is available. È possibile tuttavia configurare l'applicazione in modo che venga eseguita in base a una versione più recente dell'assembly.However, you can configure the application to run against a newer version of the assembly. Per informazioni dettagliate su come il runtime utilizza questi file per determinare la versione di assembly da utilizzare, vedere come il Runtime individua gli assembly.For details on how the runtime uses these files to determine which assembly version to use, see How the Runtime Locates Assemblies.

È possibile reindirizzare più versioni di assembly includendo più elementi bindingRedirect in un elemento dependentAssembly.You can redirect more than one assembly version by including multiple bindingRedirect elements in a dependentAssembly element. È inoltre possibile reindirizzare una versione più recente a una versione precedente dell'assembly.You can also redirect from a newer version to an older version of the assembly.

Il reindirizzamento esplicito dell'associazione di assembly in un file di configurazione di un'applicazione richiede un'autorizzazione di sicurezza,Explicit assembly binding redirection in an application configuration file requires a security permission. che vale per il reindirizzamento degli assembly .NET Framework e di quelli di altri produttori.This applies to redirection of .NET Framework assemblies and assemblies from third parties. L'autorizzazione viene concessa impostando il SecurityPermissionFlag flag di SecurityPermission.The permission is granted by setting the SecurityPermissionFlag flag on the SecurityPermission. Per ulteriori informazioni, vedere autorizzazione di sicurezza il reindirizzamento di Assembly.For more information, see Assembly Binding Redirection Security Permission.

EsempioExample

Nell'esempio seguente viene illustrato come reindirizzare una versione dell'assembly a un'altra.The following example shows how to redirect one assembly version to another.

<configuration>  
   <runtime>  
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">  
         <dependentAssembly>  
            <assemblyIdentity name="myAssembly"  
                              publicKeyToken="32ab4ba45e0a69a1"  
                              culture="neutral" />  
            <bindingRedirect oldVersion="1.0.0.0"  
                             newVersion="2.0.0.0"/>  
         </dependentAssembly>  
      </assemblyBinding>  
   </runtime>  
</configuration>  

Vedere ancheSee Also

Schema delle impostazioni di runtimeRuntime Settings Schema
Schema dei file di configurazioneConfiguration File Schema
Reindirizzamento delle versioni di assemblyRedirecting Assembly Versions