Elemento <bindingRedirect>

  • Articolo

Aggiornamento: novembre 2007

Reindirizza una versione dell'assembly in un'altra.

Elemento <Configuration>
  Elemento <runtime>
    Elemento <assemblyBinding> per <runtime>
      Elemento <dependentAssembly>
        Elemento <bindingRedirect>

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

Attributi ed elementi

Le seguenti sezioni illustrano attributi, elementi figlio e padre.

Attributi

Attributo

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

Descrizione

Nessuno

Elementi padre

Elemento

Descrizione

assemblyBinding

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

configuration

È l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

dependentAssembly

Incapsula il criterio 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 procedura di Garbage Collection.

Note

Quando si genera 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 protezione, 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 protezione 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

Concetti

Reindirizzamento delle versioni di assembly

Riferimenti

Schema delle impostazioni dell'ambiente di esecuzione

Altre risorse

Schema dei file di configurazione per .NET Framework