Migrieren von .NET Framework 1.1Migrating from the .NET Framework 1.1

Windows 7Windows 7 und neuere Versionen des Windows-Betriebssystems unterstützen .NET Framework 1.1.NET Framework 1.1 nicht. and later versions of the Windows operating system do not support the .NET Framework 1.1.NET Framework 1.1. Folglich können Anwendungen, die auf .NET Framework 1.1.NET Framework 1.1 ausgerichtet sind, unter Windows 7Windows 7 oder neueren Betriebssystemversionen nicht ohne Änderung ausgeführt werden.As a result, applications that target the .NET Framework 1.1.NET Framework 1.1 will not run without modification on Windows 7Windows 7 or later operating system versions. In diesem Thema werden die Schritte zum Ausführen einer Anwendung erläutert, die auf .NET Framework 1.1.NET Framework 1.1 unter Windows 7Windows 7 und neueren Versionen des Windows-Betriebssystems ausgerichtet ist.This topic discusses the steps required to run an application that targets the .NET Framework 1.1.NET Framework 1.1 under Windows 7Windows 7 and later versions of the Windows operating system. Weitere Informationen zu .NET Framework 1.1.NET Framework 1.1 und Windows 8Windows 8 finden Sie unter Ausführen von .NET Framework 1.1-Apps unter Windows 8 und späteren Versionen.For more information about the .NET Framework 1.1.NET Framework 1.1 and Windows 8Windows 8, see Running .NET Framework 1.1 Apps on Windows 8 and later versions.

Zuweisen einer neuen Zielversion oder NeukompilierenRetargeting or Recompiling

Es gibt zwei Möglichkeiten, eine mit .NET Framework 1.1.NET Framework 1.1 kompilierte Anwendung unter Windows 7Windows 7 oder neueren Versionen des Windows-Betriebssystems auszuführen:There are two ways to get an application that was compiled using the .NET Framework 1.1.NET Framework 1.1 to run on Windows 7Windows 7 or a later Windows operating system:

  • Sie können der Anwendung .NET Framework 4.NET Framework 4 als neue Zielversion zuweisen.You can retarget the application to run under .NET Framework 4.NET Framework 4. Für die Zuweisung einer neuen Zielversion müssen Sie der Konfigurationsdatei der Anwendung, die das Ausführen unter .NET Framework 4.NET Framework 4 ermöglicht, ein <supportedRuntime>-Element hinzufügen.Retargeting requires that you add a <supportedRuntime> element to the application's configuration file that allows it to run under .NET Framework 4.NET Framework 4. Diese Konfigurationsdatei besitzt das folgende Format:Such a configuration file takes the following form:

    <configuration>   
       <startup>  
          <supportedRuntime version="v4.0"/>  
       </startup>  
    </configuration>  
    
  • Sie können die Anwendung mit einem Compiler, der auf .NET Framework 4.NET Framework 4ausgerichtet ist, neu kompilieren.You can recompile the application with a compiler that targets the .NET Framework 4.NET Framework 4. Wenn Sie ursprünglich Visual Studio 2003 zum Entwickeln und Kompilieren Ihrer Projektmappe verwendet haben, können Sie die Projektmappe in Visual Studio 2010Visual Studio 2010 öffnen. Die Projektmappe und die Projektdateien können dann über das Dialogfeld Projektkompatibilität aus den von Visual Studio 2003 verwendeten Formaten in das Format von Microsoft Build Engine (MSBuild) konvertiert werden, das von Visual Studio 2010Visual Studio 2010verwendet wird.If you originally used Visual Studio 2003 to develop and compile your solution, you can open the solution in Visual Studio 2010Visual Studio 2010 and use the Project Compatibility dialog box to convert the solution and project files from the formats used by Visual Studio 2003 to the Microsoft Build Engine (MSBuild) format used by Visual Studio 2010Visual Studio 2010.

Unabhängig davon, ob Sie eine Neukompilierung oder eine neue Zielversion für die Anwendung vorziehen, müssen Sie bestimmen, ob die Anwendung von Änderungen betroffen ist, die in höheren Versionen von .NET Framework eingeführt wurden.Regardless of whether you prefer to recompile or retarget your application, you must determine whether your application is affected by any changes introduced in later versions of the .NET Framework. Diese Änderungen sind von zweierlei Art:These changes are of two kinds:

  • Änderungen zwischen .NET Framework 1.1.NET Framework 1.1 und höheren Versionen von .NET Framework, die die Lauffähigkeit der Anwendung beeinträchtigen.Breaking changes that occurred between the .NET Framework 1.1.NET Framework 1.1 and later versions of the .NET Framework.

  • Typen und Typmember, die zwischen .NET Framework 1.1.NET Framework 1.1 und höheren Versionen von .NET Framework als veraltet markiert wurden.Types and type members that have been marked as deprecated or obsolete between the .NET Framework 1.1.NET Framework 1.1 and later versions of the .NET Framework.

Überprüfen Sie beim Zuweisen einer neuen Zielversion und auch beim Neukompilieren sowohl die Änderungen, die die Lauffähigkeit der Anwendung beeinträchtigen, als auch die veralteten Typen und Member für jede Version von .NET Framework, die nach .NET Framework 1.1.NET Framework 1.1veröffentlicht wurde.Whether you retarget your application or recompile it, you should review both the breaking changes and the obsolete types and members for each version of the .NET Framework that was released after .NET Framework 1.1.NET Framework 1.1.

Die Lauffähigkeit der Anwendung beeinträchtigende ÄnderungenBreaking Changes

Bei einer Änderung, die die Lauffähigkeit der Anwendung beeinträchtigt, ist ggf. eine Problemumgehung sowohl für Anwendungen mit neuer Zielversion als auch für neu kompilierte Anwendungen verfügbar.When a breaking change occurs, depending on the specific change, a workaround may be available both for retargeted and recompiled applications. In einigen Fällen können Sie dem <runtime>-Element der Konfigurationsdatei der Anwendung ein untergeordnetes Element hinzufügen, um das vorherige Verhalten wiederherzustellen.In some cases, you can add a child element to the <runtime> element of your application's configuration file to restore the previous behavior. Die folgende Konfigurationsdatei stellt z. B. die in .NET Framework 1.1.NET Framework 1.1 verwendete Zeichenfolgensortierung und das Vergleichsverhalten wieder her und kann bei neu zugewiesener Zielversion oder einer neu kompilierten Anwendung verwendet werden.For example, the following configuration file restores the string sorting and comparison behavior used in the .NET Framework 1.1.NET Framework 1.1 and can be used either with a retargeted or a recompiled application.

<configuration>  
   <runtime>  
      <CompatSortNLSVersion enabled="4096"/>  
   </runtime>  
</configuration>  

In einigen Fällen müssen Sie jedoch möglicherweise den Quellcode ändern und die Anwendung neu kompilieren.However, in some cases, you may have to modify your source code and recompile your application.

Überprüfen Sie die folgende Änderungsliste, um die Auswirkungen möglicher Änderungen zu bewerten, die die Lauffähigkeit der Anwendung beeinträchtigen:To assess the impact of possible breaking changes on your application, you must review the following lists of changes:

Veraltete Typen und MemberObsolete Types and Members

Die Auswirkungen veralteter Typen und Member unterscheiden sich geringfügig bei Anwendungen mit neu zugewiesener Zielversion und neu kompilierten Anwendungen.The impact of deprecated types and members is somewhat different for retargeted applications and recompiled applications. Die Verwendung veralteter Typen und Member wirkt sich nicht auf eine Anwendung mit neuer Zielversion aus, sofern der veraltete Typ oder Member nicht physisch aus seiner Assembly entfernt wurde.The use of obsolete types and members will not affect a retargeted application unless the obsolete type or member has been physically removed from its assembly. Das Neukompilieren eine Anwendung, die veraltete Typen oder Member verwendet, erzeugt in der Regel eher eine Compilerwarnung als einen Compilerfehler.Recompiling an application that uses obsolete types or members usually produces a compiler warning rather than a compiler error. In einigen Fällen wird jedoch ein Compilerfehler verursacht, und Code, in dem der veraltete Typ oder Member verwendet wird, kann nicht erfolgreich kompiliert werden.However, in some cases, it produces a compiler error, and code that uses the obsolete type or member does not compile successfully. Sie müssen dann den Quellcode neu schreiben, der den veralteten Typ oder Member aufruft, bevor Sie die Anwendung neu kompilieren.In this case, you must rewrite the source code that calls the obsolete type or member before you recompile your application. Weitere Informationen zu veralteten Typen und Membern finden Sie unter Veraltete Elemente in der Klassenbibliothek.For more information about obsolete types and members, see What's Obsolete in the Class Library.

Nähere Informationen zur Bewertung der Auswirkungen von Typen und Membern, die seit dem Release von .NET Framework 2.0 SP1.NET Framework 2.0 SP1 veraltet sind, finden Sie unter Veraltete Elemente in der Klassenbibliothek.To assess the impact of types and members that have been deprecated since the release of the .NET Framework 2.0 SP1.NET Framework 2.0 SP1, see What's Obsolete in the Class Library. Überprüfen Sie die Listen der veralteten Typen und Member für .NET Framework 2.0 SP1.NET Framework 2.0 SP1, .NET Framework 3,5.NET Framework 3.5 und .NET Framework 4.NET Framework 4.Review the lists of obsolete types and member for the .NET Framework 2.0 SP1.NET Framework 2.0 SP1, the .NET Framework 3,5.NET Framework 3.5, and the .NET Framework 4.NET Framework 4.