Vorgehensweise: Konfigurieren einer App zur Unterstützung von .NET Framework 4 oder höher

Alle Apps, die die Common Language Runtime (CLR) hosten, müssen die CLR starten oder aktivieren, um verwalteten Code auszuführen. Normalerweise wird eine .NET Framework-App in der CLR-Version ausgeführt, für die sie erstellt wurde, aber Sie können dieses Verhalten für Desktop-Apps ändern, indem Sie eine Anwendungskonfigurationsdatei (auch als app.config-Datei bezeichnet) verwenden. Das Standardaktivierungsverhalten für Windows Store-Apps oder Windows Phone-Apps kann jedoch nicht mit einer Anwendungskonfigurationsdatei geändert werden. In diesem Artikel wird beschrieben, wie Sie eine Desktop-App in einer anderen Version von .NET Framework ausführen, und wie auf die Version 4 oder höher abgezielt werden kann.

Die Version von .NET Framework, in der eine Anwendung ausgeführt wird, wird in folgender Reihenfolge ermittelt:

  • Konfigurationsdatei.

    Wenn die Anwendungskonfigurationsdatei unterstützteRuntime-Einträge> enthält<, die eine oder mehrere .NET Framework Versionen angeben und eine dieser Versionen auf dem Computer des Benutzers vorhanden ist, wird die App auf dieser Version ausgeführt. Die Konfigurationsdatei liest <unterstützteRuntime-Einträge> in der aufgeführten Reihenfolge und verwendet die erste .NET Framework Version, die auf dem Computer des Benutzers vorhanden ist. (Verwenden Sie das <erforderlicheRuntime-Element> für Version 1.0.)

  • Kompilierte Version.

    Wenn keine Konfigurationsdatei vorhanden ist, aber die Version von .NET Framework, für die die App erstellt wurde, auf dem Computer des Benutzers installiert ist, wird die App in dieser Version ausgeführt.

  • Neueste installierte Version.

    Wenn die Version der .NET Framework, auf der die App erstellt wurde, nicht vorhanden ist und eine Konfigurationsdatei keine Version in einem <unterstütztenRuntime-Element> angibt, versucht die App, auf der neuesten Version der .NET Framework auszuführen, die auf dem Computer des Benutzers vorhanden ist.

    .NET Framework 1.0, 1.1, 2.0, 3.0 und 3.5 Apps werden jedoch nicht automatisch auf dem .NET Framework 4 oder höher ausgeführt, und in einigen Fällen wird der Benutzer möglicherweise aufgefordert, .NET Framework 3.5 zu installieren. Das Aktivierungsverhalten hängt möglicherweise auch vom Betriebssystem des Benutzers ab, da verschiedene Versionen des Windows-Systems verschiedene Versionen des .NET Framework enthalten. Wenn Ihre App .NET Framework 3.5 und 4 oder höher unterstützt, wird empfohlen, dies mit mehreren Einträgen in der Konfigurationsdatei kenntlich zu machen, um .NET Framework-Initialisierungsfehler zu vermeiden. Weitere Informationen finden Sie unter Versionen und Abhängigkeiten.

Sie sollten ggf. auch die .NET Framework 3.5-Apps so konfigurieren, dass sie unter .NET Framework 4 oder höher ausgeführt werden können, und zwar auch bei Computern, auf denen .NET Framework 3.5 installiert ist, da Sie so von den Leistungsverbesserungen in den Versionen 4 und höher profitieren können.

Wichtig

Es wird empfohlen, die Apps immer für jede .NET Framework-Version zu testen, die die App unterstützen soll. Weitere Informationen zum Upgrade von Anwendungen zur Unterstützung höherer .NET Framework-Versionen erhalten Sie unter Versionskompatibilität.

Informationen zum Ändern der .NET Framework 1.0- und 1.1-Apps für Windows 7 und Windows 8 finden Sie unter Migrieren von .NET Framework 1.1.

So konfigurieren Sie Ihre App für .NET Framework 4 oder höher

  1. Suchen Sie die Konfigurationsdatei für das .NET Framework-Projekt, oder fügen Sie sie hinzu. Die Konfigurationsdatei für eine App befindet sich im gleichen Verzeichnis wie die App und hat den gleichen Namen wie die App, weist aber eine CONFIG-Erweiterung auf. Die Anwendungskonfigurationsdatei für die App "MyExecutable.exe" heißt z. B. "MyExecutable.exe.config".

    Um eine Konfigurationsdatei über die Visual Studio-Menüleiste hinzuzufügen, wählen Sie Projekt, Neues Element hinzufügen aus. Wählen Sie im linken Bereich Allgemein, und wählen Sie dann Konfigurationsdatei aus. Benennen Sie die Konfigurationsdatei mit App.config. Diese Menüelemente sind nicht für Windows Store-App- oder Windows Phone-App-Projekte verfügbar, da die Aktivierungsrichtlinie auf diesen Plattformen nicht geändert werden kann.

  2. Fügen Sie das <unterstützteRuntime-Element> wie folgt zur Anwendungskonfigurationsdatei hinzu:

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

    in der <Version> wird die CLR-Version angegeben, die mit der .NET Framework Version übereinstimmt, die Ihre App unterstützt. Verwenden Sie diese Zeichenfolgen:

    • .NET Framework 1.0: "v1.0.3705"

    • .NET Framework 1.1: "v1.1.4322"

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

    • .NET Framework 4 und höhere Versionen: „v4.0“

    Sie können mehrere unterstützteRuntime-Elemente> hinzufügen, die in der Reihenfolge der Einstellung aufgeführt sind, um die Unterstützung für mehrere< Versionen der .NET Framework anzugeben.

Die folgende Tabelle zeigt, wie mit den Einstellungen der Anwendungskonfigurationsdatei und den auf einem Computer installierten .NET Framework-Versionen die Version ermittelt wird, in der eine .NET Framework 3.5-App ausgeführt wird. Die Beispiele beziehen sich konkret auf eine .NET Framework 3.5-Anwendung, allerdings folgen Zielanwendungen, die mit früheren .NET Framework-Versionen erstellt werden, der gleichen Logik. Beachten Sie, dass die .NET Framework 2.0-Versionsnummer (v2.0.50727) verwendet wird, um .NET Framework 3.5 in der Anwendungskonfigurationsdatei anzugeben.

App.config-Dateieinstellung Auf Computer mit installierter Version 3.5 Auf Computer mit installierter Version 3.5, 4 oder höher Auf Computer mit installierter Version 4 oder höher
Keine Wird unter 3.5 ausgeführt Wird unter 3.5 ausgeführt Zeigt eine Fehlermeldung an, in der der Benutzer aufgefordert wird, die richtige Version zu installieren.*
<supportedRuntime version="v2.0.50727"/> Wird unter 3.5 ausgeführt Wird unter 3.5 ausgeführt Zeigt eine Fehlermeldung an, in der der Benutzer aufgefordert wird, die richtige Version zu installieren.*
<supportedRuntime version="v2.0.50727"/>
<supportedRuntime version="v4.0"/>
Wird unter 3.5 ausgeführt Wird unter 3.5 ausgeführt Kann auf Version 4 oder höher ausgeführt werden
<supportedRuntime version="v4.0"/>
<supportedRuntime version="v2.0.50727"/>
Wird unter 3.5 ausgeführt Kann auf Version 4 oder höher ausgeführt werden Kann auf Version 4 oder höher ausgeführt werden
<supportedRuntime version="v4.0"/> Zeigt eine Fehlermeldung an, in der der Benutzer aufgefordert wird, die richtige Version zu installieren.* Kann auf Version 4 oder höher ausgeführt werden Kann auf Version 4 oder höher ausgeführt werden

* Weitere Informationen zu dieser Fehlermeldung und Methoden zum Vermeiden dieser Fehlermeldung finden Sie unter .NET Framework Initialisierungsfehler: Verwalten der Benutzeroberfläche.

Siehe auch