<requiredRuntime> , element

  • Artykuł

Określa, że aplikacja obsługuje tylko wersję 1.0 środowiska uruchomieniowego języka wspólnego. Ten element jest przestarzały i nie powinien już być używany. supportedRuntime Zamiast tego należy użyć elementu .

<Konfiguracji>
  <Uruchamiania>
    <requiredRuntime>

Składnia

   <requiredRuntime  
version="runtime version"
safemode="true|false"/>

Atrybuty i elementy

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

Atrybuty

Atrybut Opis
version Atrybut opcjonalny.

Wartość ciągu określająca wersję .NET Framework obsługiwaną przez tę aplikację. Wartość ciągu musi być zgodna z nazwą katalogu znalezionego w katalogu głównym instalacji .NET Framework. Zawartość wartości ciągu nie jest analizowana.
safemode Atrybut opcjonalny.

Określa, czy kod uruchamiania środowiska uruchomieniowego przeszukuje rejestr w celu określenia wersji środowiska uruchomieniowego.

safemode, atrybut

Wartość Opis
false Kod uruchamiania środowiska uruchomieniowego wygląda w rejestrze. Jest to wartość domyślna.
true Kod uruchamiania środowiska uruchomieniowego nie wyszukuje w rejestrze.

Elementy podrzędne

Brak.

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.
startup <requiredRuntime> Zawiera element .

Uwagi

Aplikacje utworzone w celu obsługi tylko wersji 1.0 środowiska uruchomieniowego muszą używać <requiredRuntime> elementu . Aplikacje utworzone przy użyciu wersji 1.1 lub nowszej środowiska uruchomieniowego muszą używać <supportedRuntime> elementu .

Uwaga

Jeśli używasz funkcji CorBindToRuntimeByCfg do określenia pliku konfiguracji, musisz użyć <requiredRuntime> elementu dla wszystkich wersji środowiska uruchomieniowego. Element <supportedRuntime> jest ignorowany podczas korzystania z polecenia CorBindToRuntimeByCfg.

Ciąg version atrybutu musi być zgodny z nazwą folderu instalacyjnego dla określonej wersji .NET Framework. Ten ciąg nie jest interpretowany. Jeśli kod uruchomienia środowiska uruchomieniowego nie znajdzie pasującego folderu, środowisko uruchomieniowe nie zostanie załadowane; kod uruchamiania wyświetla komunikat o błędzie i kończy działanie.

Przykład

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

<configuration>
   <startup>
      <requiredRuntime version="v1.0.3705" safemode="true"/>
   </startup>
</configuration>

Zobacz też