Instrukcje: konfigurowanie aplikacji do obsługi programu .NET Framework w wersji 4 lub nowszej

  • Artykuł

Wszystkie aplikacje hostujące środowisko uruchomieniowe języka wspólnego (CLR) muszą uruchomić lub aktywować środowisko CLR w celu uruchomienia kodu zarządzanego. Zazwyczaj aplikacja programu .NET Framework działa w wersji środowiska CLR, w którym została skompilowana, ale można zmienić to zachowanie dla aplikacji komputerowych, używając pliku konfiguracji aplikacji (czasami określanego jako plik app.config). Przy użyciu pliku konfiguracji aplikacji nie można jednak zmienić domyślnego zachowania aktywacji dla aplikacji do Sklepu Windows lub dla systemu Windows Phone. W tym artykule wyjaśniono, jak umożliwić uruchamianie aplikacji klasycznej w innej wersji programu .NET Framework i przedstawiono przykład sposobu kierowania wersji 4 lub nowszej.

Wersja programu .NET Framework, w której działa aplikacja, jest określana w następującej kolejności:

  • Plik konfiguracji.

    Jeśli plik konfiguracji aplikacji zawiera <obsługiwane wpisyRuntime> , które określają co najmniej jedną wersję programu .NET Framework, a jedna z tych wersji jest obecna na komputerze użytkownika, aplikacja jest uruchamiana w tej wersji. Plik konfiguracji odczytuje <obsługiwane wpisyRuntime> w kolejności, w której są wymienione, i używa pierwszej wymienionej wersji programu .NET Framework, która znajduje się na komputerze użytkownika. (Użyj <requiredRuntime> , element dla wersji 1.0.

  • Skompilowana wersja.

    Jeśli nie ma pliku konfiguracji, ale wersja programu .NET Framework, z użyciem której skompilowano aplikację, jest obecna na komputerze użytkownika, aplikacja jest uruchamiana z użyciem tej wersji.

  • Najnowsza zainstalowana wersja.

    Jeśli wersja programu .NET Framework, na podstawie którego utworzono aplikację, nie jest obecna, a plik konfiguracji nie określa wersji w obsługiwanym <elemecieRuntime>, aplikacja próbuje uruchomić w najnowszej wersji programu .NET Framework, która znajduje się na komputerze użytkownika.

    Jednak aplikacje .NET Framework 1.0, 1.1, 2.0, 3.0 i 3.5 nie są uruchamiane automatycznie w programie .NET Framework 4 lub nowszym, a w niektórych przypadkach użytkownik może otrzymać błąd i może zostać wyświetlony monit o zainstalowanie programu .NET Framework 3.5. Zachowanie aktywacji może także zależeć od systemu operacyjnego użytkownika, ponieważ różne wersje systemu Windows zawierają różne wersje programu .NET Framework. Jeśli aplikacja obsługuje programy .NET Framework 3.5 i 4 lub nowsze, zalecane jest, aby wskazać to za pomocą wielu wpisów w pliku konfiguracji, co pozwoli uniknąć błędów inicjowania programu .NET Framework. Aby uzyskać więcej informacji, zobacz Wersje i zależności.

Możesz również skonfigurować aplikacje programu .NET Framework 3.5 do uruchamiania w wersji .NET Framework 4 lub nowszej, nawet na komputerach z zainstalowanym programem .NET Framework 3.5, aby korzystać z ulepszeń wydajności w wersjach 4 i nowszych.

Ważne

Zalecane jest, aby zawsze testować aplikację z każdą wersją programu .NET Framework, która jest obsługiwana. Zobacz Zgodność wersji, aby uzyskać informacje na temat uaktualniania aplikacji do obsługi nowszych wersji programu .NET Framework.

Aby uzyskać informacje o modyfikowaniu aplikacji .NET Framework 1.0 i 1.1 w celu obsługi systemów Windows 7 i Windows 8, zobacz Migrowanie z programu .NET Framework 1.1.

Aby skonfigurować aplikację do uruchamiania w programie .NET Framework 4 lub nowszym

  1. Dodaj lub zlokalizuj plik konfiguracji projektu programu .NET Framework. Plik konfiguracji aplikacji znajduje się w tym samym katalogu i ma taką samą nazwę jak aplikacja, ale ma rozszerzenie .config. Na przykład dla aplikacji o nazwie MyExecutable.exe plik konfiguracji aplikacji ma nazwę MyExecutable.exe.config.

    Aby dodać plik konfiguracji, na pasku menu programu Visual Studio wybierz pozycję Projekt, Dodaj nowy element. Wybierz pozycję Ogólne w okienku po lewej stronie, a następnie wybierz pozycję Plik konfiguracji. Nadaj plikowi konfiguracji nazwę App.config. Te opcje menu nie są dostępne dla projektów aplikacji ze Sklepu Windows lub aplikacji dla systemu Windows Phone, ponieważ nie można zmienić zasad aktywacji na tych platformach.

  2. <Dodaj element supportedRuntime> w następujący sposób do pliku konfiguracji aplikacji:

    <configuration>
  <startup>
    <supportedRuntime version="version"/>
  </startup>
</configuration>

    gdzie <wersja określa wersję> środowiska CLR zgodną z wersją programu .NET Framework obsługiwaną przez aplikację. Użyj następujących ciągów:

    • .NET Framework 1.0: "v1.0.3705"

    • .NET Framework 1.1: "v1.1.4322"

    • .NET Framework 2.0, 3.0 i 3.5: "v2.0.50727"

    • .NET Framework 4 i nowsze wersje: "v4.0"

    Można dodać wiele <obsługiwanych elementówRuntime> wymienionych w kolejności preferencji, aby określić obsługę wielu wersji programu .NET Framework.

W poniższej tabeli pokazano, jak na podstawie ustawień w pliku konfiguracji aplikacji i wersji programu .NET Framework zainstalowanych na komputerze można ustalić wersję, w której będzie działać aplikacja przeznaczona dla środowiska .NET Framework 3.5. Przykłady są specyficzne dla aplikacji programu .NET Framework 3.5, ale można używać podobnej logiki w przypadku aplikacjach docelowych, które zostały skompilowane z użyciem starszych wersji programu .NET Framework. Należy zauważyć, że numer wersji programu .NET Framework 2.0 (v2.0.50727) jest używany do określenia programu .NET Framework 3.5 w pliku konfiguracji aplikacji.

Ustawienie w pliku App.config Na komputerze z zainstalowaną wersją 3.5 Na komputerze z zainstalowanymi wersjami 3.5 i 4 lub nowszymi Na komputerze z zainstalowaną wersją 4 lub nowszą
Brak Działa w wersji 3.5 Działa w wersji 3.5 Wyświetla komunikat o błędzie, który monituje użytkownika o zainstalowanie poprawnej wersji *
<supportedRuntime version="v2.0.50727"/> Działa w wersji 3.5 Działa w wersji 3.5 Wyświetla komunikat o błędzie, który monituje użytkownika o zainstalowanie poprawnej wersji *
<supportedRuntime version="v2.0.50727"/>
<supportedRuntime version="v4.0"/>		 Działa w wersji 3.5 Działa w wersji 3.5 Działa w wersji 4 lub nowszej
<supportedRuntime version="v4.0"/>
<supportedRuntime version="v2.0.50727"/>		 Działa w wersji 3.5 Działa w wersji 4 lub nowszej Działa w wersji 4 lub nowszej
<supportedRuntime version="v4.0"/> Wyświetla komunikat o błędzie, który monituje użytkownika o zainstalowanie poprawnej wersji * Działa w wersji 4 lub nowszej Działa w wersji 4 lub nowszej

* Aby uzyskać więcej informacji na temat tego komunikatu o błędzie i sposobów jego uniknięcia, zobacz Błędy inicjowania programu .NET Framework: Zarządzanie środowiskiem użytkownika.

Zobacz też