<supportPortability-element>

Artikel
05/10/2023

Hiermee geeft u op dat een toepassing kan verwijzen naar dezelfde assembly in twee verschillende implementaties van de .NET Framework, door het standaardgedrag uit te schakelen dat de assembly's als gelijkwaardig beschouwt voor toepassingsoverdraagbaarheidsdoeleinden.

<configuratie>
  <Runtime>
    <assemblyBinding>
      <supportPortability>

Syntax

<supportPortability PKT="public_key_token" enabled="true|false"/>

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Kenmerk	Beschrijving
PKT	Vereist kenmerk. Hiermee geeft u het token van de openbare sleutel van de betrokken assembly, als een tekenreeks.
enabled	Optioneel kenmerk. Hiermee geeft u op of ondersteuning voor draagbaarheid tussen implementaties van de opgegeven .NET Framework assembly moet worden ingeschakeld.

ingeschakeld kenmerk

Waarde	Beschrijving
true	Ondersteuning voor draagbaarheid tussen implementaties van de opgegeven .NET Framework assembly inschakelen. Dit is de standaardinstelling.
onjuist	Schakel ondersteuning voor draagbaarheid tussen implementaties van de opgegeven .NET Framework assembly uit. Hierdoor kan de toepassing verwijzingen hebben naar meerdere implementaties van de opgegeven assembly.

Onderliggende elementen

Geen.

Bovenliggende elementen

Element	Beschrijving
`configuration`	Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.
`runtime`	Bevat informatie over assemblybinding en garbagecollection.
`assemblyBinding`	Bevat informatie over omleiding van assemblyversies en de locaties van assembly's.

Opmerkingen

Vanaf de .NET Framework 4 wordt automatisch ondersteuning geboden voor toepassingen die twee implementaties van de .NET Framework kunnen gebruiken, bijvoorbeeld de .NET Framework-implementatie of de .NET Framework voor silverlight-implementatie. De twee implementaties van een bepaalde .NET Framework assembly worden door de assemblyband als gelijkwaardig beschouwd. In enkele scenario's veroorzaakt deze functie voor overdraagbaarheid van toepassingen problemen. In deze scenario's kan het <supportPortability> -element worden gebruikt om de functie uit te schakelen.

Een dergelijk scenario is een assembly die moet verwijzen naar zowel de .NET Framework-implementatie als de .NET Framework voor silverlight-implementatie van een bepaalde referentieassembly. Een XAML-ontwerper die is geschreven in Windows Presentation Foundation (WPF), moet bijvoorbeeld verwijzen naar zowel de WPF Desktop-implementatie voor de gebruikersinterface van de ontwerper als de subset van WPF die is opgenomen in de Silverlight-implementatie. Standaard veroorzaken de afzonderlijke verwijzingen een compilerfout, omdat assemblybinding de twee assembly's als gelijkwaardig ziet. Met dit element wordt het standaardgedrag uitgeschakeld en kan de compilatie worden voltooid.

Belangrijk

Als u wilt dat de compiler de informatie doorgeeft aan de assemblybindingslogica van de algemene taalruntime, moet u de /appconfig compileroptie gebruiken om de locatie op te geven van het app.config-bestand dat dit element bevat.

Voorbeeld

In het volgende voorbeeld kan een toepassing verwijzingen hebben naar zowel de .NET Framework-implementatie als de .NET Framework voor silverlight-implementatie van elke .NET Framework assembly die in beide implementaties bestaat. De /appconfig compileroptie moet worden gebruikt om de locatie van dit app.config-bestand op te geven.

<configuration>  
   <runtime>  
      <assemblyBinding>  
         <supportPortability PKT="7cec85d7bea7798e" enable="false"/>  
         <supportPortability PKT="31bf3856ad364e35" enable="false"/>  
      </assemblyBinding>  
   </runtime>  
</configuration>

Delen via