Konfigurowanie przekierowywania powiązań zestawów
Uwaga
Ten artykuł jest specyficzny dla programu .NET Framework. Nie ma zastosowania do nowszych implementacji platformy .NET, w tym .NET 6 i nowszych wersji.
Domyślnie aplikacje używają zestawu zestawów .NET Framework dostarczanych z wersją środowiska uruchomieniowego używanego do kompilowania aplikacji. Można użyć atrybutu appliesTo w <elemencie assemblyBinding> w pliku konfiguracji aplikacji, aby przekierować odwołania powiązania zestawu do określonej wersji zestawów .NET Framework. Ten opcjonalny atrybut używa numeru wersji programu .NET Framework, aby wskazać, której wersji dotyczy. Jeśli nie określono atrybutu appliesTo , <element assemblyBinding> ma zastosowanie do wszystkich wersji programu .NET Framework.
Atrybut appliesTo został wprowadzony w programie .NET Framework w wersji 1.1; jest ignorowany przez program .NET Framework w wersji 1.0. Oznacza to, że wszystkie elementy assemblyBinding> są stosowane podczas korzystania z programu .NET Framework w wersji 1.0, nawet jeśli określono atrybut appliedTo.<
Uwaga
Użyj atrybutu appliesTo , aby ograniczyć przekierowywanie powiązań zestawów do określonej wersji środowiska uruchomieniowego.
Aby na przykład przekierować powiązanie zestawu dla zestawu .NET Framework w wersji 1.0, należy dołączyć następujący kod XML w pliku konfiguracji aplikacji.
<runtime>
<assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
<dependentAssembly>
* assembly information goes here *
</dependentAssembly>
</assemblyBinding>
</runtime>
<Elementy assemblyBinding> są wrażliwe na kolejność. Najpierw należy wprowadzić informacje przekierowania powiązania zestawu dla wszystkich zestawów programu .NET Framework w wersji 1.0, a następnie informacje o przekierowywaniu powiązań zestawów dla wszystkich zestawów programu .NET Framework w wersji 1.1. Na koniec wprowadź informacje przekierowania powiązania zestawu dla każdego przekierowania zestawu .NET Framework, które nie używa atrybutu appliesTo , a w związku z tym dotyczy wszystkich wersji programu .NET Framework. W przypadku konfliktu w przekierowaniu jest używana pierwsza zgodna instrukcja przekierowania w pliku konfiguracji.
Aby na przykład przekierować jedno odwołanie do zestawu .NET Framework w wersji 1.0 i inne odwołanie do zestawu .NET Framework w wersji 1.1, należy użyć wzorca pokazanego w poniższym pseudokodzie.
<assemblyBinding xmlns="..." appliesTo="v1.0.3705">
<!-- .NET Framework version 1.0 redirects here. -->
</assemblyBinding>
<assemblyBinding xmlns="..." appliesTo="v1.1.4322">
<!-- .NET Framework version 1.1 redirects here. -->
</assemblyBinding>
<assemblyBinding xmlns="...">
<!-- Redirects meant for all versions of the .NET Framework. -->
</assemblyBinding>
Debugowanie błędów pliku konfiguracji
Środowisko uruchomieniowe analizuje pliki konfiguracji raz po utworzeniu domeny aplikacji i ładuje kod do tej domeny aplikacji. Środowisko uruchomieniowe języka wspólnego obsługuje błędy w pliku konfiguracji, ignorując wpis. Środowisko uruchomieniowe ignoruje cały plik konfiguracji, jeśli zawiera nieprawidłowo sformułowany kod XML. W przypadku nieprawidłowego kodu XML tylko nieprawidłowe sekcje są ignorowane.
Można określić, czy plik konfiguracji jest używany, określając, czy występują przekierowania powiązań zestawu. Użyj Podglądu dziennika powiązań zestawów (Fuslogvw.exe), aby zobaczyć, które zestawy są ładowane. Aby wyświetlić wszystkie powiązania zestawów, należy ustawić wpis forcelog w rejestrze.
