<element uruchamiania>

Artykuł
05/09/2023

Określa informacje o uruchamianiu środowiska uruchomieniowego języka wspólnego.

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut	Opis
`useLegacyV2RuntimeActivationPolicy`	Atrybut opcjonalny. Określa, czy włączyć zasady aktywacji środowiska uruchomieniowego .NET Framework 2.0, czy użyć zasad aktywacji .NET Framework 4.

useLegacyV2RuntimeActivationPolicy atrybut

Wartość Opis

true Włącz zasady aktywacji środowiska uruchomieniowego .NET Framework 2.0 dla wybranego środowiska uruchomieniowego, które polega na powiązaniu starszych technik aktywacji środowiska uruchomieniowego (takich jak funkcja CorBindToRuntimeEx) do środowiska uruchomieniowego wybranego z pliku konfiguracji, a nie ograniczenia ich w środowisku CLR w wersji 2.0. W związku z tym, jeśli wersja CLR w wersji 4 lub nowszej zostanie wybrana z pliku konfiguracji, zestawy trybu mieszanego utworzone z wcześniejszymi wersjami .NET Framework są ładowane z wybraną wersją CLR. Ustawienie tej wartości uniemożliwia ładowanie środowiska CLR w wersji 1.1 lub CLR w wersji 2.0 do tego samego procesu, co skutecznie wyłącza funkcję równoległą procesu.

false Użyj domyślnych zasad aktywacji dla .NET Framework 4 i nowszych, które umożliwiają starsze techniki aktywacji środowiska uruchomieniowego w celu załadowania środowiska CLR w wersji 1.1 lub 2.0 do procesu. Ustawienie tej wartości uniemożliwia ładowanie zestawów w trybie mieszanym do .NET Framework 4 lub nowszej, chyba że zostały utworzone z .NET Framework 4 lub nowszym. Ta wartość jest domyślna.

Wartość	Opis
`true`	Włącz zasady aktywacji środowiska uruchomieniowego .NET Framework 2.0 dla wybranego środowiska uruchomieniowego, które polega na powiązaniu starszych technik aktywacji środowiska uruchomieniowego (takich jak funkcja CorBindToRuntimeEx) do środowiska uruchomieniowego wybranego z pliku konfiguracji, a nie ograniczenia ich w środowisku CLR w wersji 2.0. W związku z tym, jeśli wersja CLR w wersji 4 lub nowszej zostanie wybrana z pliku konfiguracji, zestawy trybu mieszanego utworzone z wcześniejszymi wersjami .NET Framework są ładowane z wybraną wersją CLR. Ustawienie tej wartości uniemożliwia ładowanie środowiska CLR w wersji 1.1 lub CLR w wersji 2.0 do tego samego procesu, co skutecznie wyłącza funkcję równoległą procesu.
`false`	Użyj domyślnych zasad aktywacji dla .NET Framework 4 i nowszych, które umożliwiają starsze techniki aktywacji środowiska uruchomieniowego w celu załadowania środowiska CLR w wersji 1.1 lub 2.0 do procesu. Ustawienie tej wartości uniemożliwia ładowanie zestawów w trybie mieszanym do .NET Framework 4 lub nowszej, chyba że zostały utworzone z .NET Framework 4 lub nowszym. Ta wartość jest domyślna.

Elementy podrzędne

Element	Opis
<requiredRuntime>	Określa, że aplikacja obsługuje tylko wersję 1.0 środowiska uruchomieniowego języka wspólnego. Aplikacje utworzone przy użyciu środowiska uruchomieniowego w wersji 1.1 lub nowszej powinny używać obsługiwanego< elementuRuntime>.
<supportedRuntime>	Określa wersje środowiska uruchomieniowego języka wspólnego, które obsługuje aplikacja.

Elementy nadrzędne

Element	Opis
`configuration`	Element główny w każdym pliku konfiguracji używanym przez środowisko uruchomieniowe języka wspólnego i aplikacje programu .NET Framework.

Uwagi

<Obsługiwany elementRuntime> powinien być używany przez wszystkie aplikacje utworzone przy użyciu wersji 1.1 lub nowszej środowiska uruchomieniowego. Aplikacje utworzone w celu obsługi tylko wersji 1.0 środowiska uruchomieniowego muszą używać wymaganego< elementuRuntime>.

Atrybut useLegacyV2RuntimeActivationPolicy

Ten atrybut jest przydatny, jeśli aplikacja używa starszych ścieżek aktywacji, takich jak funkcja CorBindToRuntimeEx, i chcesz, aby te ścieżki aktywowały wersję 4 środowiska CLR zamiast starszej wersji, lub jeśli aplikacja została skompilowana z .NET Framework 4, ale ma zależność od zestawu trybu mieszanego utworzonego z wcześniejszą wersją .NET Framework. W tych scenariuszach ustaw atrybut na true.

Uwaga

Ustawienie atrybutu w taki sposób, aby true uniemożliwiał ładowanie środowiska CLR w wersji 1.1 lub CLR w wersji 2.0 do tego samego procesu, skutecznie wyłączając funkcję równoległą procesu (zobacz Wykonywanie równoległe dla międzyoperacyjną modelu COM).

Przykład

W poniższym przykładzie pokazano, jak określić wersję środowiska uruchomieniowego w pliku konfiguracji.

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

Udostępnij za pośrednictwem