Sequenza di ricerca dell'assemblaggio

Se un'applicazione isolata specifica una dipendenza da un assembly, la ricerca side-by-side inizialmente cerca l'assembly tra gli assembly condivisi nella cartella WinSxS. Se l'assembly richiesto non viene trovato, side-by-side cerca un assembly privato installato in una cartella della struttura di directory dell'applicazione.

gli assembly privati possono essere distribuiti nei percorsi seguenti nella struttura di directory dell'applicazione:

• Nella cartella dell'applicazione. In genere, si tratta della cartella contenente il file eseguibile dell'applicazione.
• In una sottocartella nella cartella dell'applicazione. La sottocartella deve avere lo stesso nome dell'assembly.
• In una sottocartella specifica della lingua nella cartella dell'applicazione. Il nome della sottocartella è una stringa di codici DHTML che indicano una lingua-cultura o una lingua.
• In una sottocartella di una sottocartella specifica della lingua nella cartella dell'applicazione. Il nome della sottocartella principale è una stringa di codici di lingua DHTML che indicano una lingua-cultura o una lingua. La sottocartella più profonda ha lo stesso nome dell'assembly.

La prima volta che si esegue una ricerca affiancata di un assembly privato, si determina se esiste una sottocartella specifica per la lingua nella struttura delle directory dell'applicazione. Se non esiste alcuna sottocartella specifica del linguaggio, cerca l'assembly privato nei percorsi seguenti usando la sequenza seguente.

1. Esegue una ricerca affiancata nella cartella WinSxS.
2. \\<appdir>\<nome assembly>.DLL
3. \\<appdir>\<nome dell'assembly>.manifest
4. \\<appdir>\<nomeAssembly>\<nomeAssembly>.DLL
5. \\<appdir>\<nome_assembly>\<nome_assembly>.manifest

Se esiste una sottocartella specifica del linguaggio, la struttura di directory dell'applicazione può contenere l'assembly privato localizzato in più lingue. Esegue una ricerca affiancata nelle sottocartelle specifiche della lingua per assicurarsi che l'applicazione usi la lingua specificata o la lingua migliore disponibile. Le sottocartelle specifiche per lingua vengono denominate usando una stringa di codici DHTML di lingua che specificano una lingua-cultura o una lingua. Se esiste una sottocartella specifica del linguaggio, cerca l'assembly privato nei percorsi seguenti usando la sequenza seguente.

1. La ricerca side-by-side analizza la cartella WinSxS.
2. \\<appdir>\<language-culture>\<assemblyname>.DLL
3. \\<appdir>\<language-culture>\<nome dell'assembly>.manifest
4. \\<appdir>\<language-culture>\<nome_assembly>\<nome_assembly>.DLL
5. \\<appdir>\<language-culture>\<nome assembly>\ nome assembly<>.manifest

Si noti che la sequenza di ricerca side-by-side trova un file DLL con il nome dell'assembly e si arresta prima di cercare un file manifesto con il nome dell'assembly. Il modo consigliato per gestire un assembly privato che è una DLL consiste nell'inserire il manifesto dell'assembly nel file DLL come risorsa. L'ID risorsa deve essere uguale a 1 e il nome dell'assembly privato può essere lo stesso del nome della DLL. Ad esempio, se il nome della DLL è MICROSOFT.WINDOWS.MYSAMPLE.DLL, il valore dell'attributo name usato nell'elemento assemblyIdentity del manifest dell'assembly può anche essere Microsoft.Windows.mysample. In alternativa, è possibile inserire il manifesto dell'assembly in un file separato, ma il nome dell'assembly e il relativo manifesto devono quindi essere diversi dal nome della DLL. Ad esempio, Microsoft.Windows.mysampleAsm, Microsoft.Windows.mysampleAsm.manifest e MICROSOFT.WINDOWS.MYSAMPLE.DLL.

Ad esempio, se myapp è installata nella radice dell'unità c: e richiede myasm in francese-belga, il metodo side-by-side utilizza la sequenza seguente per cercare la migliore approssimazione di un'istanza localizzata di myasm.

1. Esegue una ricerca affiancata in WinSxS per la versione fr-be.
2. c:\myapp\fr-be\myasm.dll
3. c:\myapp\fr-be\myasm.manifest
4. c:\myapp\fr-be\myasm\myasm.dll
5. c:\myapp\fr-be\myasm\myasm.manifest
6. Esegue una ricerca parallela in WinSxS per la versione francese.
7. c:\myapp\fr\myasm.dll
8. c:\myapp\fr\myasm.manifest
9. c:\myapp\fr\myasm\myasm.dll
10. c:\myapp\fr\myasm\myasm.manifest
11. Esegue una ricerca affiancata in WinSxS per la versione en-us.
12. c:\myapp\en-us\myasm.dll
13. c:\myapp\en-us\myasm.manifest
14. c:\myapp\en-us\myasm\myasm.dll
15. c:\myapp\en-us\myasm\myasm.manifest
16. Side-by-side cerca WinSxS per la versione en.
17. c:\myapp\en\myasm.dll
18. c:\myapp\en\myasm.manifest
19. c:\myapp\en\myasm\myasm.dll
20. c:\myapp\en\myasm\myasm.manifest
21. Side-by-side cerca WinSxS per la versione senza lingua.
22. c:\myapp\myasm.dll
23. c:\myapp\myasm.manifest
24. c:\myapp\myasm\myasm.dll
25. c:\myapp\myasm\myasm.manifest

Se la ricerca side-by-side raggiunge una versione indipendente dal linguaggio dell'assembly e una versione MUI (Multilanguage User Interface) di Windows è presente nel sistema, la ricerca side-by-side tenta di effettuare il binding a <assemblyname>.mui. Side-by-side non tenta di eseguire l'associazione a <nome assembly>.mui se la ricerca raggiunge una versione localizzata dell'assembly. Il manifesto dell'assembly di un assembly indipendente dalla lingua non avrà un attributo language nel relativo elemento assemblyIdentity. Se il side-by-side raggiunge un assembly indipendente dalla lingua e MUI è installato, side-by-side esegue una ricerca nei percorsi seguenti usando la sequenza seguente per <nome assembly>.mui. Side-by-side usa la stessa sequenza di ricerca se l'assembly è indipendente dalle impostazioni cultura, ad eccezione <non viene eseguita alcuna ricerca nella lingua>.

1. Esegue una ricerca side-by-side nella cartella WinSxS di <nome dell'assembly>.mui.
2. \\<lingua-cultura dell'utente>\<nome dell'assembly>.mui
3. \\<lingua dell'utente>\<assemblyname>.mui
4. \\<lingua-cultura del sistema>\<assemblyname>.mui
5. \\<lingua del sistema>\<nome dell'assembly>.mui
6. \\<nessuna lingua>\<assemblyname>.mui

Ad esempio, se la ricerca parallela trova l'assembly privato in c:\myapp\myasm\myasm.manifest e myasm è un assembly indipendente dal linguaggio. Nella modalità side-by-side, viene quindi utilizzata la sequenza seguente per cercare myasm.mui. Si noti che side-by-side non cercherà un assembly MUI indipendente dalla lingua.

1. Esegue una ricerca side-by-side in WinSxS per la versione fr-be dell'assembly MUI.
2. c:\myapp\fr-be\myasm.mui.dll
3. c:\myapp\fr-be\myasm.mui.manifest
4. c:\myapp\fr-be\myasm\myasm.mui.dll
5. c:/myapp/fr-be/myasm/myasm.mui.manifest
6. Esegue una ricerca parallela in WinSxS per la versione fr dell'assembly MUI.
7. c:\myapp\fr\myasm.mui.dll
8. c:\myapp\fr\myasm.mui.manifest
9. c:\myapp\fr\myasm\myasm.mui.dll
10. c:\myapp\fr\myasm\myasm.mui.manifest
11. Esegue una ricerca in affiancamento in WinSxS per la versione en-us dell'assembly MUI.
12. c:\myapp\en-us\myasm.mui.dll
13. c:\myapp\en-us\myasm.mui.manifest
14. c:\myapp\en-us\myasm\myasm.mui.dll
15. c:\myapp\en-us\myasm\myasm.mui.manifest
16. Esegue una ricerca parallela in WinSxS per la versione en dell'assembly MUI.
17. c:\myapp\en\myasm.mui.dll
18. c:\myapp\en\myasm.mui.manifest
19. c:\myapp\en\myasm\myasm.mui.dll
20. c:\myapp\en\myasm\myasm.mui.manifest