<supportedRuntime,> element

Określa, która wersja środowiska uruchomieniowego języka wspólnego i opcjonalnie .NET Framework wersji, którą obsługuje aplikacja.

<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. Prawidłowe wartości atrybutu można znaleźć version w sekcji wartości "wersja środowiska uruchomieniowego ". Uwaga: Za pośrednictwem .NET Framework 3.5 wartość "wersja środowiska uruchomieniowego" przyjmuje postać główna. pomocniczy. kompilacja. Począwszy od wersji .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ę magazynową (SKU), która z kolei określa, .NET Framework obsługuje ta aplikacja.

Począwszy od .NET Framework 4.0, zaleca się sku użycie atrybutu. Gdy ta aplikacja jest obecna, wskazuje wersję .NET Framework docelowego aplikacji.

Prawidłowe wartości atrybutu sku można znaleźć w sekcji wartości "identyfikator sku ".

Uwagi

Jeśli element <supportedRuntime> nie znajduje się w pliku konfiguracji aplikacji, używana jest wersja środowiska uruchomieniowego używanego do kompilowania aplikacji.

Element <supportedRuntime> powinien być używany przez wszystkie aplikacje sbudowaną przy użyciu wersji 1.1 lub nowszej środowiska uruchomieniowego. Aplikacje, które obsługują tylko wersję 1.0 środowiska uruchomieniowego, muszą używać elementu< requiredRuntime>.

Uwaga

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

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

<Jeśli element supportedRuntime>sku z atrybutem znajduje się w pliku konfiguracji, a zainstalowana wersja programu .NET Framework jest niższa niż określona obsługiwana wersja, uruchomienie aplikacji nie powiedzie się i zamiast tego zostanie wyświetlony komunikat z prośbą o zainstalowanie obsługiwanej wersji. W przeciwnym razie aplikacja próbuje uruchomić się w dowolnej zainstalowanej wersji, ale może zachowywać się nieoczekiwanie, jeśli nie jest w pełni zgodna z tą wersją. (Aby uzyskać informacje o różnicach zgodności między .NET Framework, zobacz Zgodność aplikacji w .NET Framework). W związku z tym zalecamy dołącznie tego elementu do pliku konfiguracji aplikacji w celu ułatwienia diagnostyki błędów. (Plik konfiguracji generowany automatycznie przez 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 clr zamiast starszej wersji lub jeśli aplikacja została s zbudowana przy użyciu programu .NET Framework 4, ale ma zależność od zestawu w trybie mieszanym sbudowaną przy użyciu starszej wersji pakietu .NET Framework, nie wystarczy określić .NET Framework 4 na liście obsługiwanych środowisk uruchomieniowych. Ponadto w elemencie <startowym> w pliku konfiguracji należy ustawić atrybut useLegacyV2RuntimeActivationPolicy na true. Jednak ustawienie tego true atrybutu na wartość oznacza, że wszystkie składniki sbudowaną przy użyciu wcześniejszych wersji .NET Framework są uruchamiane przy użyciu .NET Framework 4 zamiast środowisk uruchomieniowych, za pomocą których zostały sbudowaną.

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. Należy pamiętać, że .NET Framework wersji 4.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 "v4.0"

Wartości "identyfikator sku"

Atrybut sku używa monikera docelowej struktury (TFM), aby wskazać wersję .NET Framework docelową i wymaganą do uruchomienia aplikacji. W poniższej tabeli wymieniono prawidłowe wartości, które są obsługiwane przez sku 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"

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

Zobacz też