Szerelvénykötés átirányításának konfigurálása

Megjegyzés:

Ez a cikk a .NET-keretrendszerre vonatkozik. Ez nem vonatkozik a .NET újabb implementációira, beleértve a .NET 6-os és újabb verzióit.

Alapértelmezés szerint az alkalmazások az alkalmazás fordításához használt futtatókörnyezeti verzióval szállított .NET-keretrendszer-szerelvényeket használják. Az alkalmazáskonfigurációs fájl > átirányíthatja a szerelvénykötési hivatkozásokat a .NET-keretrendszer szerelvények egy adott verziójára. Ez az opcionális attribútum .NET-keretrendszer verziószámmal jelzi, hogy melyik verzióra vonatkozik. Ha nincs appliesTo megadva attribútum, az <assemblyBinding> elem a .NET-keretrendszer összes verziójára vonatkozik.

Az appliesTo attribútum az .NET-keretrendszer 1.1-es verziójában lett bevezetve; a .NET-keretrendszer 1.0-s verziója figyelmen kívül hagyja. Ez azt jelenti, hogy minden <assemblyBinding> elem az .NET-keretrendszer 1.0-s verziójának használatakor lesz alkalmazva, még akkor is, ha egy appliesTo attribútum meg van adva.

Megjegyzés:

Az attribútummal korlátozhatja a appliesTo szerelvénykötés átirányítását a futtatókörnyezet egy adott verziójára.

Ha például egy .NET-keretrendszer 1.0-s verziójához szeretné átirányítani a szerelvénykötést, az alkalmazáskonfigurációs fájlban a következő XML-kódot kell tartalmaznia.

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

Az <assemblyBinding> elemek sorrendfüggőek. Először minden .NET-keretrendszer 1.0-s verziójú szerelvény szerelvénykötés-átirányítási információit kell megadnia, majd a .NET-keretrendszer 1.1-es verziójú szerelvények szerelvénykötés-átirányítási információit. Végül adja meg a szerelvénykötés átirányítási adatait minden olyan .NET-keretrendszer-szerelvény-átirányításhoz, amely nem használja az appliesTo attribútumot, és ezért a .NET-keretrendszer összes verziójára vonatkozik. Átirányítás ütközése esetén a rendszer a konfigurációs fájl első egyező átirányítási utasítását használja.

Ha például egy hivatkozást egy .NET-keretrendszer 1.0-s verziójának szerelvényére szeretne átirányítani, egy másik pedig egy .NET-keretrendszer 1.1-es verziójára mutató szerelvényre mutató hivatkozást, az alábbi pszeudokódban látható mintát használná.

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

Konfigurációs fájl hibáinak hibakeresése

A futtatókörnyezet egyszer elemzi a konfigurációs fájlokat egy alkalmazástartomány létrehozásakor, és betölti a kódot ebbe az alkalmazástartományba. A közös nyelvi futtatókörnyezet a bejegyzés figyelmen kívül hagyásával kezeli a konfigurációs fájl hibáit. A futtatókörnyezet figyelmen kívül hagyja a teljes konfigurációs fájlt, ha hibás XML-t tartalmaz. Érvénytelen XML esetén a rendszer csak az érvénytelen szakaszokat hagyja figyelmen kívül.

Annak meghatározásához, hogy egy konfigurációs fájl van-e használatban, meghatározhatja, hogy szerelvénykötés-átirányítások történnek-e. A szerelvénykötési naplómegjelenítő (Fuslogvw.exe) segítségével megtekintheti, hogy mely szerelvények vannak betöltve. Az összes szerelvénykötés megtekintéséhez be kell állítania a ForceLog bejegyzését a beállításjegyzékben.

Lásd még

• Útmutató: Automatikus kötésátirányítás engedélyezése és letiltása