<supportedRuntime> , element

Artykuł
05/10/2023

Określa, która wersja środowiska uruchomieniowego języka wspólnego i, opcjonalnie, .NET Framework wersja obsługiwana przez aplikację.

<Konfiguracji>
<Uruchamiania>
<supportedRuntime>

Składnia

<supportedRuntime version="runtime version" sku="SKU ID"/>

Atrybuty

Atrybut Opis

Wersja Atrybut opcjonalny.

Wartość ciągu określająca wersję środowiska uruchomieniowego języka wspólnego (CLR), którą obsługuje ta aplikacja. Aby uzyskać prawidłowe wartości atrybutuversion, zobacz sekcję "wersja środowiska uruchomieniowego". Uwaga: Za pomocą .NET Framework 3.5 wartość "wersja środowiska uruchomieniowego" ma postać główną. drobne. kompilacja. Począwszy od .NET Framework 4, wymagane są tylko numery wersji głównych i pomocniczych (czyli "v4.0" zamiast "v4.0.30319"). Zalecane jest użycie krótszego ciągu.

Numer jednostki magazynowej Atrybut opcjonalny.

Wartość ciągu określająca jednostkę przechowywania zapasów (SKU), która z kolei określa, które .NET Framework wydania obsługuje ta aplikacja.

Od .NET Framework 4.0 zaleca się użycie atrybutusku. Gdy jest obecny, wskazuje wersję .NET Framework, że aplikacja jest przeznaczona.

Aby uzyskać prawidłowe wartości atrybutusku, zobacz sekcję "Identyfikator jednostki SKU".

Atrybut	Opis
Wersja	Atrybut opcjonalny. Wartość ciągu określająca wersję środowiska uruchomieniowego języka wspólnego (CLR), którą obsługuje ta aplikacja. Aby uzyskać prawidłowe wartości atrybutu`version`, zobacz sekcję "wersja środowiska uruchomieniowego". Uwaga: Za pomocą .NET Framework 3.5 wartość "wersja środowiska uruchomieniowego" ma postać główną. drobne. kompilacja. Począwszy od .NET Framework 4, wymagane są tylko numery wersji głównych i pomocniczych (czyli "v4.0" zamiast "v4.0.30319"). Zalecane jest użycie krótszego ciągu.
Numer jednostki magazynowej	Atrybut opcjonalny. Wartość ciągu określająca jednostkę przechowywania zapasów (SKU), która z kolei określa, które .NET Framework wydania obsługuje ta aplikacja. Od .NET Framework 4.0 zaleca się użycie atrybutu`sku`. Gdy jest obecny, wskazuje wersję .NET Framework, że aplikacja jest przeznaczona. Aby uzyskać prawidłowe wartości atrybutu`sku`, zobacz sekcję "Identyfikator jednostki SKU".

Uwagi

<Jeśli obsługiwany elementRuntime> nie jest obecny w pliku konfiguracji aplikacji, używana jest wersja środowiska uruchomieniowego używanego do kompilowania aplikacji.

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

Uwaga

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

W przypadku aplikacji obsługujących wersje środowiska uruchomieniowego z .NET Framework od 1.1 do 3.5, gdy jest obsługiwanych wiele wersji środowiska uruchomieniowego, pierwszy element powinien określić najbardziej preferowaną wersję środowiska uruchomieniowego, a ostatni element powinien określać najmniej preferowaną wersję. W przypadku aplikacji obsługujących wersje version .NET Framework 4.0 lub nowszych atrybut wskazuje wersję środowiska CLR, która jest wspólna dla .NET Framework 4 i nowszych wersji, a sku atrybut wskazuje pojedynczą wersję .NET Framework przeznaczoną dla aplikacji.

<Jeśli obsługiwany elementRuntime> z atrybutem sku znajduje się w pliku konfiguracji, a zainstalowana wersja .NET Framework jest niższa niż określona obsługiwana wersja, nie można uruchomić aplikacji, a zamiast tego zostanie wyświetlony komunikat z prośbą o zainstalowanie obsługiwanej wersji. W przeciwnym razie aplikacja próbuje uruchomić w dowolnej zainstalowanej wersji, ale może ona zachowywać się nieoczekiwanie, jeśli nie jest w pełni zgodna z tą wersją. (Aby uzyskać różnice w zgodności między wersjami .NET Framework, zobacz zgodność aplikacji w .NET Framework). W związku z tym zalecamy dołączenie tego elementu do pliku konfiguracji aplikacji w celu ułatwienia diagnostyki błędów. (Plik konfiguracji generowany automatycznie przez program Visual Studio podczas tworzenia nowego projektu już go zawiera).

Uwaga

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 wcześniejszej 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, nie wystarczy określić .NET Framework 4 na liście obsługiwanych środowisk uruchomieniowych. Ponadto w elemecie startowym<> w pliku konfiguracji należy ustawić useLegacyV2RuntimeActivationPolicy atrybut na true. Jednak ustawienie tego atrybutu true oznacza, że wszystkie składniki utworzone we wcześniejszych wersjach .NET Framework są uruchamiane przy użyciu .NET Framework 4 zamiast środowisk uruchomieniowych, z którymi zostały skompilowane.

Zalecane jest, aby testować aplikacje z każdą wersją programu .NET Framework, za pomocą której mogą być uruchamiane.

Wartości "wersja środowiska uruchomieniowego"

Atrybut runtime określa wersję środowiska uruchomieniowego języka wspólnego (CLR), która jest wymagana dla danej aplikacji. Wszystkie wersje .NET Framework v4.x określają clRv4.0. W poniższej tabeli wymieniono prawidłowe wartości dla wartości wersji środowiska uruchomieniowego atrybutu version .

Wersja programu .NET Framework	Atrybut `version`
1.0	"v1.0.3705"
1.1	"v1.1.4322"
2.0	"v2.0.50727"
3.0	"v2.0.50727"
3,5	"v2.0.50727"
4.0-4.8.1	"v4.0"

Wartości "IDENTYFIKATOR jednostki SKU"

Atrybut sku używa nazwy moniker platformy docelowej (TFM), aby wskazać wersję .NET Framework, że aplikacja jest przeznaczona i wymaga jej uruchomienia. W poniższej sku tabeli wymieniono prawidłowe wartości obsługiwane przez atrybut, począwszy od .NET Framework 4.

Wersja programu .NET Framework	Atrybut `sku`
4,0	". NETFramework,Version=v4.0"
4.0, profil klienta	". NETFramework,Version=v4.0,Profile=Client"
4.0, aktualizacja platformy 1	". NETFramework,Version=v4.0.1"
4.0, Profil klienta, aktualizacja 1	". NETFramework,Version=v4.0.1,Profile=Client"
4.0, aktualizacja platformy 2	". NETFramework,Version=v4.0.2"
4.0, Profil klienta, aktualizacja 2	". NETFramework,Version=v4.0.2,Profile=Client"
4.0, aktualizacja platformy 3	". NETFramework,Version=v4.0.3"
4.0, Profil klienta, aktualizacja 3	". NETFramework,Version=v4.0.3,Profile=Client"
4.5	". NETFramework,Version=v4.5"
4.5.1	". NETFramework,Version=v4.5.1"
4.5.2	". NETFramework,Version=v4.5.2"
4,6	". NETFramework,Version=v4.6"
4.6.1	". NETFramework,Version=v4.6.1"
4.6.2	". NETFramework,Version=v4.6.2"
4.7	". NETFramework,Version=v4.7"
4.7.1	". NETFramework,Version=v4.7.1"
4.7.2	". NETFramework,Version=v4.7.2"
4.8	". NETFramework,Version=v4.8"
4.8.1	". NETFramework,Version=v4.8.1"

Przykład

W poniższym przykładzie pokazano, jak określić obsługiwaną wersję środowiska uruchomieniowego w pliku konfiguracji. Plik konfiguracji wskazuje, że aplikacja jest przeznaczona .NET Framework 4.7.

<configuration>
   <startup>
      <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.7" />
   </startup>
</configuration>

Plik konfiguracji

Tego elementu można użyć w pliku konfiguracji aplikacji.