Condividi tramite


Creazione di copie replicate di assembly

Nota

Questo articolo è specifico per .NET Framework. Non si applica alle implementazioni più recenti di .NET, incluse .NET 6 e versioni successive.

La creazione di copie shadow consente di aggiornare gli assembly usati in un dominio applicazione senza scaricare quest'ultimo. Ciò è particolarmente utile per le applicazioni che devono essere disponibili in modo continuo, ad esempio siti ASP.NET.

Importante

La creazione di copie shadow non è supportata nelle app Windows 8.x Store.

Common Language Runtime blocca un file di assembly quando l'assembly è caricato, in modo che non sia possibile aggiornare il file finché l'assembly non sarà stato scaricato. L'unico modo per scaricare un assembly da un dominio applicazione consiste nello scaricare il dominio applicazione; pertanto, in circostanze normali, non è possibile aggiornare un assembly su disco fino a quando tutti i domini applicazione che lo usano non saranno stati scaricati.

Quando un dominio applicazione è configurato per la copia shadow di file, gli assembly dal percorso dell'applicazione vengono copiati in un'altra posizione e caricati da tale posizione. La copia è bloccata, ma il file di assembly originale è sbloccato e può essere aggiornato.

Importante

Gli unici assembly che possono essere replicati mediante copia shadow sono quelli memorizzati nella directory dell'applicazione o nelle relative sottodirectory, specificato dalle proprietà ApplicationBase e PrivateBinPath quando viene configurato il dominio applicazione. Gli assembly memorizzati nella Global Assembly Cache non vengono replicati mediante copia shadow.

In questo articolo sono contenute le sezioni seguenti:

  • Abilitazione e uso della creazione di copie shadow: illustra l'uso di base e le opzioni disponibili per la copia shadow.

  • Prestazioni di avvio: illustra le modifiche che vengono apportate alla copia shadow in .NET Framework 4 per migliorare le prestazioni di avvio e come ripristinare il funzionamento delle versioni precedenti.

  • Metodi obsoleti: illustra le modifiche apportate ai metodi e alle proprietà che controllano la creazione di copie shadow in .NET Framework 2.0.

Abilitazione e uso della creazione di copie shadow

È possibile usare le proprietà della classe AppDomainSetup come indicato di seguito per configurare un dominio applicazione per la creazione di copie shadow:

  • Abilitare la creazione di copie shadow impostando la proprietà ShadowCopyFiles sul valore della stringa "true".

    Per impostazione predefinita, tutti gli assembly nel percorso dell'applicazione verranno copiati in una Download Cache prima che vengano caricati. Si tratta della stessa cache gestita da Common Language Runtime per archiviare i file scaricati da altri computer ed eliminare automaticamente i file quando non sono più necessari.

  • Facoltativamente, impostare un percorso personalizzato per i file di copia shadow usando la proprietà CachePath e la proprietà ApplicationName.

    Il percorso di base della posizione è costituito dalla concatenazione della proprietà ApplicationName alla proprietà CachePath come sottodirectory. Gli assembly vengono replicati nelle sottodirectory di questo percorso, non nel percorso di base.

    Nota

    Se la proprietà ApplicationName non è impostata, la proprietà CachePath viene ignorata e viene usata la Download Cache. Non viene generata alcuna eccezione.

    Se si specifica un percorso personalizzato, si è responsabili della pulizia delle directory e dei file copiati quando non sono più necessari, perché non vengono eliminati automaticamente.

    Esistono diversi motivi per cui è consigliabile impostare un percorso personalizzato per i file della copia shadow, ad esempio se l'applicazione genera un numero elevato di copie. La Download Cache è limitata dalle dimensioni, non dalla durata, pertanto è possibile che Common Language Runtime proverà a eliminare un file che è ancora in uso. Un altro motivo per impostare un percorso personalizzato è quando gli utenti che eseguono l'applicazione non hanno accesso in scrittura al percorso di directory che Common Language Runtime usa per la Download Cache.

  • Facoltativamente, limitare gli assembly che vengono replicati usando la proprietà ShadowCopyDirectories.

    Quando si abilita la creazione di copie shadow per un dominio applicazione, l'impostazione predefinita consiste nel copiare tutti gli assembly nel percorso dell'applicazione, ovvero nelle directory specificate dalle proprietà ApplicationBase e PrivateBinPath. È possibile limitare la copia alle directory selezionate creando una stringa che contiene solo le directory per cui si vogliono creare copie shadow e assegnando la stringa alla proprietà ShadowCopyDirectories. Separare le directory con punti e virgola. Gli unici assembly che vengono replicati sono quelli nelle directory selezionate.

    Nota

    Se non si assegna una stringa alla proprietà ShadowCopyDirectories o se si imposta questa proprietà su null, tutti gli assembly nelle directory specificate dalle proprietà ApplicationBase e PrivateBinPath vengono replicati come copie shadow.

    Importante

    I percorsi delle directory non devono contenere punti e virgola, perché il punto e virgola è il carattere delimitatore. Non esiste alcun carattere di escape per i punti e virgola.

Prestazioni di avvio

All'avvio di un dominio applicazione che usa la creazione di copie shadow, si verifica un ritardo mentre gli assembly nella directory dell'applicazione vengono copiati nella directory di copia shadow o verificati, se si trovano già in tale posizione. Nelle versioni precedenti a .NET Framework 4, tutti gli assembly vengono copiati in una directory temporanea. Ogni assembly è stato aperto per verificare il nome dell'assembly e il nome sicuro è stato convalidato. Ogni assembly è stato controllato per verificare se è stato aggiornato più di recente rispetto alla copia nella directory della copia shadow. In tal caso, è stato copiato nella directory della copia shadow. Infine, le copie temporanee vengono rimosse.

A partire da .NET Framework 4, il comportamento di avvio predefinito consiste nel confrontare direttamente la data e l'ora del file di ogni assembly nella directory dell'applicazione con la data e l'ora della copia nella directory della copia shadow. Se l'assembly è stato aggiornato, viene copiato usando la stessa procedura adottata nelle versioni precedenti di .NET Framework. In caso contrario, viene caricata la copia nella directory della copia shadow.

Il miglioramento delle prestazioni risultante è maggiore per le applicazioni in cui gli assembly non vengono modificati di frequente e le modifiche vengono apportate in genere in un piccolo subset di assembly. Se la maggior parte degli assembly in un'applicazione viene modificata frequentemente, il nuovo comportamento predefinito potrebbe causare una regressione delle prestazioni. È possibile ripristinare il comportamento di avvio delle versioni precedenti di .NET Framework aggiungendo l'elemento <shadowCopyVerifyByTimestamp> al file di configurazione con enabled="false".

Metodi obsoleti

La classe AppDomain include diversi metodi, ad esempio SetShadowCopyFiles e ClearShadowCopyPath, che possono essere usati per controllare la creazione di copie shadow in un dominio applicazione, ma che sono stati contrassegnati come obsoleti nella versione 2.0 di .NET Framework. Il modo consigliato per configurare un dominio applicazione per la creazione di copie shadow consiste nell'usare le proprietà della classe AppDomainSetup.

Vedi anche