<opstartelement>

Artikel
05/10/2023

Hiermee geeft u algemene opstartgegevens voor runtime op.

Syntax

<startup useLegacyV2RuntimeActivationPolicy="true|false" >
</startup>

Kenmerken en elementen

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

Kenmerken

Kenmerk	Beschrijving
`useLegacyV2RuntimeActivationPolicy`	Optioneel kenmerk. Hiermee geeft u op of het activeringsbeleid voor .NET Framework 2.0 runtime moet worden ingeschakeld of dat het activeringsbeleid .NET Framework 4 moet worden gebruikt.

useLegacyV2RuntimeActivationPolicy-kenmerk

Waarde Beschrijving

true Schakel .NET Framework 2.0-runtimeactiveringsbeleid in voor de gekozen runtime. Dit is om verouderde runtimeactiveringstechnieken (zoals de functie CorBindToRuntimeEx) te binden aan de runtime die is gekozen uit het configuratiebestand in plaats van ze te beperken op CLR-versie 2.0. Dus als CLR versie 4 of hoger wordt gekozen uit het configuratiebestand, worden assembly's in gemengde modus die zijn gemaakt met eerdere versies van de .NET Framework geladen met de gekozen CLR-versie. Als u deze waarde instelt, voorkomt u dat CLR versie 1.1 of CLR versie 2.0 in hetzelfde proces wordt geladen, waardoor de functie naast elkaar wordt uitgeschakeld.

false Gebruik het standaardactiveringsbeleid voor de .NET Framework 4 en hoger. Dit is om verouderde runtimeactiveringstechnieken toe te staan CLR-versie 1.1 of 2.0 in het proces te laden. Als u deze waarde instelt, voorkomt u dat assembly's met gemengde modus worden geladen in de .NET Framework 4 of hoger, tenzij ze zijn gebouwd met de .NET Framework 4 of hoger. Dit is de standaardwaarde.

Waarde	Beschrijving
`true`	Schakel .NET Framework 2.0-runtimeactiveringsbeleid in voor de gekozen runtime. Dit is om verouderde runtimeactiveringstechnieken (zoals de functie CorBindToRuntimeEx) te binden aan de runtime die is gekozen uit het configuratiebestand in plaats van ze te beperken op CLR-versie 2.0. Dus als CLR versie 4 of hoger wordt gekozen uit het configuratiebestand, worden assembly's in gemengde modus die zijn gemaakt met eerdere versies van de .NET Framework geladen met de gekozen CLR-versie. Als u deze waarde instelt, voorkomt u dat CLR versie 1.1 of CLR versie 2.0 in hetzelfde proces wordt geladen, waardoor de functie naast elkaar wordt uitgeschakeld.
`false`	Gebruik het standaardactiveringsbeleid voor de .NET Framework 4 en hoger. Dit is om verouderde runtimeactiveringstechnieken toe te staan CLR-versie 1.1 of 2.0 in het proces te laden. Als u deze waarde instelt, voorkomt u dat assembly's met gemengde modus worden geladen in de .NET Framework 4 of hoger, tenzij ze zijn gebouwd met de .NET Framework 4 of hoger. Dit is de standaardwaarde.

Onderliggende elementen

Element	Beschrijving
<requiredRuntime>	Hiermee geeft u op dat de toepassing alleen versie 1.0 van de common language runtime ondersteunt. Toepassingen die zijn gebouwd met runtimeversie 1.1 of hoger, moeten het <element supportedRuntime> gebruiken.
<supportedRuntime>	Hiermee geeft u op welke versies van de common language runtime de toepassing ondersteunt.

Bovenliggende elementen

Element	Beschrijving
`configuration`	Het hoofdelement in elk configuratiebestand dat wordt gebruikt door de common language runtime en .NET Framework toepassingen.

Opmerkingen

Het <element supportedRuntime> moet worden gebruikt door alle toepassingen die zijn gebouwd met versie 1.1 of hoger van de runtime. Toepassingen die zijn gebouwd om alleen versie 1.0 van de runtime te ondersteunen, moeten het <element requiredRuntime> gebruiken.

Het kenmerk useLegacyV2RuntimeActivationPolicy

Dit kenmerk is handig als uw toepassing verouderde activeringspaden gebruikt, zoals de functie CorBindToRuntimeEx, en u wilt dat deze paden versie 4 van de CLR activeren in plaats van een eerdere versie, of als uw toepassing is gebouwd met de .NET Framework 4, maar afhankelijk is van een assembly voor gemengde modus die is gebouwd met een eerdere versie van de .NET Framework. Stel in deze scenario's het kenmerk in op true.

Notitie

Als u het kenmerk instelt op true , voorkomt u dat CLR versie 1.1 of CLR versie 2.0 in hetzelfde proces wordt geladen, waardoor de in-process side-by-side-functie effectief wordt uitgeschakeld (zie Side-by-Side Execution voor COM Interop).

Voorbeeld

In het volgende voorbeeld ziet u hoe u de runtimeversie in een configuratiebestand opgeeft.

<!-- When used with version 1.0 of the .NET Framework runtime -->
<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>
<!-- When used with version 1.1 (or later) of the runtime -->
<configuration>
   <startup>
      <supportedRuntime version="v1.1.4322"/>
      <supportedRuntime version="v1.0.3705"/>
   </startup>
</configuration>

Delen via