Condividi tramite

Elemento <bindingRedirect>

  • Articolo

Reindirizza una versione dell'assembly in un'altra.

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

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute

Oggetto di descrizione

oldVersion

Attributo obbligatorio.

Specifica la versione dell'assembly che era stata richiesta in origine. Il formato di un numero di versione di assembly è principale.secondaria.build.revisione. I valori validi per ogni parte del numero di versione sono compresi tra 0 e 65535.

È possibile anche specificare una gamma di versioni nel seguente formato:

n.n.n.n - n.n.n.n

newVersion

Attributo obbligatorio.

Specifica la versione dell'assembly da utilizzare al posto della versione richiesta in origine nel formato: n.n.n.n

Elementi figlio

Elemento

Oggetto di descrizione

Nessuna correzione

Elementi padre

Elemento

Oggetto di descrizione

assemblyBinding

Contiene le informazioni sul reindirizzamento della versione degli assembly e i relativi percorsi.

configuration

Elemento radice in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

dependentAssembly

Incapsula i criteri di associazione e il percorso dell'assembly per ciascun assembly. Utilizzare un elemento dependentAssembly per ciascun assembly.

runtime

Contiene le informazioni sull'associazione degli assembly e la Garbage Collection.

Note

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. È possibile tuttavia configurare l'applicazione in modo che venga eseguita in base a una versione più recente dell'assembly. Per ulteriori informazioni su come tali file vengono gestiti nell'ambiente di esecuzione per determinare la versione dell'assembly da utilizzare, vedere Modalità di individuazione di assembly dell'ambiente di esecuzione.

È possibile reindirizzare più versioni di assembly includendo più elementi bindingRedirect in un elemento dependentAssembly.

Il reindirizzamento esplicito dell'associazione di assembly in un file di configurazione di un'applicazione richiede un'autorizzazione di sicurezza, che vale per il reindirizzamento degli assembly .NET Framework e di quelli di altri produttori. Tale autorizzazione viene concessa impostando il flag BindingRedirects sulla classe SecurityPermission. Per ulteriori informazioni, vedere Autorizzazione di sicurezza per il reindirizzamento delle versioni di assembly.

Esempio

Nell'esempio seguente viene illustrato come reindirizzare una versione dell'assembly in un'altra.

<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 anche

Riferimenti

Schema delle impostazioni dell'ambiente di esecuzione

Concetti

Reindirizzamento delle versioni di assembly

Altre risorse

Schema dei file di configurazione per .NET Framework