<requiredRuntime> , element
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>
