Konfigurace přesměrování vazby sestavení

Poznámka:

Tento článek je specifický pro rozhraní .NET Framework. Nevztahuje se na novější implementace .NET, včetně .NET 6 a novějších verzí.

Aplikace ve výchozím nastavení používají sadu sestavení rozhraní .NET Framework, která jsou dodávána s verzí modulu runtime použitou ke kompilaci aplikace. Atribut u elementu appliesTo<assemblyBinding> v konfiguračním souboru aplikace můžete použít k přesměrování odkazů na vazby sestavení na konkrétní verzi sestavení rozhraní .NET Framework. Tento volitelný atribut používá číslo verze rozhraní .NET Framework k označení, na kterou verzi se vztahuje. Pokud není zadán žádný appliesTo atribut, <assemblyBinding> element se vztahuje na všechny verze rozhraní .NET Framework.

Atribut appliesTo byl zaveden v rozhraní .NET Framework verze 1.1; je ignorován rozhraním .NET Framework verze 1.0. To znamená, že všechny <assemblyBinding> prvky se použijí při použití rozhraní .NET Framework verze 1.0, i když appliesTo je zadaný atribut.

Poznámka:

Pomocí atributu appliesTo omezte přesměrování vazby sestavení na konkrétní verzi běhového prostředí.

Například, chcete-li přesměrovat vazbu knihovny pro rozhraní .NET Framework verze 1.0, vložte do konfiguračního souboru aplikace následující kód XML.

<runtime>
        <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1" appliesTo="v1.0.3705">
            <dependentAssembly>
               * assembly information goes here *
            </dependentAssembly>
       </assemblyBinding>
</runtime>

Prvky <assemblyBinding> jsou citlivé na pořadí. Nejprve byste měli zadat informace o přesměrování vazby sestavení pro všechna sestavení rozhraní .NET Framework verze 1.0, následované informacemi o přesměrování vazby sestavení pro všechna sestavení rozhraní .NET Framework verze 1.1. Nakonec zadejte informace o přesměrování vazeb sestavení pro přesměrování sestavení v rozhraní .NET Framework, které nepoužívá atribut appliesTo a proto se vztahuje na všechny verze rozhraní .NET Framework. V případě konfliktu při přesměrování se použije první odpovídající příkaz přesměrování v konfiguračním souboru.

Pokud například chcete přesměrovat jeden odkaz na sestavení .NET Framework verze 1.0 a jiný odkaz na sestavení .NET Framework verze 1.1, použili byste vzor zobrazený v následujícím pseudokódu.

<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>

Ladění chyb v konfiguračním souboru

Modul runtime analyzuje konfigurační soubory jednou při vytvoření domény aplikace a načte kód do této domény aplikace. Modul CLR (Common Language Runtime) zpracovává chyby v konfiguračním souboru ignorováním položky. Modul runtime ignoruje celý konfigurační soubor, pokud obsahuje poškozený kód XML. Pro neplatný kód XML se ignorují pouze neplatné oddíly.

Můžete zjistit, jestli se konfigurační soubor používá, tak, že zjistíte, zda dochází k přesměrování vazeb sestavení. Pomocí Prohlížeče protokolu vazby sestavení (Fuslogvw.exe) zjistěte, která sestavení se načítají. Chcete-li zobrazit všechny vazby sestavení, musíte v registru nastavit položku ForceLog.

Viz také

• Postupy: Povolení a zakázání automatického přesměrování vazby