<Elemento bindingRedirect>

  • Articolo

Reindirizza una versione dell'assembly in un'altra.

<Configurazione>
  <Runtime>
    <assemblyBinding>
      <dependentAssembly>
        <bindingRedirect>

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo Descrizione
oldVersion Attributo obbligatorio.

Specifica la versione dell'assembly richiesta in origine. Il formato di un numero di versione dell'assembly è major.minor.build.revision. I valori validi per ogni parte del numero di versione sono compresi tra 0 e 65535.

È inoltre possibile 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 usare invece della versione originariamente richiesta nel formato n.n.n.n

Questo valore può specificare una versione precedente di oldVersion.

Elementi figlio

Elemento Descrizione
nessuno

Elementi padre

Elemento Descrizione
assemblyBinding Contiene le informazioni sul reindirizzamento della versione degli assembly e i relativi percorsi.
configuration Elemento radice in ciascun file di configurazione usato 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 informazioni sull'associazione degli assembly e sull'operazione di Garbage Collection.

Commenti

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 informazioni dettagliate su come il runtime usa questi file per determinare la versione dell'assembly da usare, vedere Come il runtime individua gli assembly.

È possibile reindirizzare più versioni di assembly includendo più elementi bindingRedirect in un elemento dependentAssembly. È inoltre possibile reindirizzare una versione più recente a una versione precedente dell'assembly.

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. L'autorizzazione viene concessa impostando il SecurityPermissionFlag flag su SecurityPermission. Per altre informazioni, vedere Autorizzazioni di sicurezza per il reindirizzamento dell'associazione di assembly.

Esempio

Nell'esempio seguente viene illustrato come reindirizzare una versione dell'assembly a 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>

Vedi anche