Exemplarische Vorgehensweise: Konvertieren eines Visual Studio 2002- oder 2003-Webprojekts in ein Visual Studio 2008-Webanwendungsprojekt

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird beschrieben, wie Sie ein Visual Studio .NET 2002- oder Visual Studio .NET 2003-Webprojekt in ein Visual Studio 2008-Webanwendungsprojekt konvertieren. Das Visual Studio 2008-Webanwendungsprojekt-Modell ähnelt dem Visual Studio 2005-Webanwendungsprojekt-Modell. Deshalb ähneln sich auch die Konvertierungsprozesse. Weitere Informationen über Webanwendungsprojekte finden Sie unter Übersicht über Webanwendungsprojekte.

Sie können eine Konvertierung auch von einem Visual Studio .NET-Webprojekt in ein Visual Studio 2008-Websiteprojekt durchführen. Der unterstützte Ansatz ist jedoch die Konvertierung eines Webanwendungsprojekts, wobei Sie die Hilfe der entsprechenden Tools in Anspruch nehmen können. Beim Konvertieren in ein Visual Studio 2008-Webanwendungsprojekt können Sie z. B. den Visual Studio-Konvertierungs-Assistenten verwenden, um einen Teil des Prozesses zu automatisieren. Weitere Informationen dazu, wie Sie ein Visual Studio .NET-Webprojekt in eine Visual Studio 2008-Website konvertieren, finden Sie unter Häufige Probleme bei Webprojektkonvertierungen und ihre Lösungen (möglicherweise in englischer Sprache).

Die Konvertierung eines Visual Studio 2002- oder 2003-Webprojekts in ein Visual Studio 2008-Webanwendungsprojekt besteht aus zwei Schritten. Die beiden Schritte lauten:

Konvertieren des Projekts. Sie können den Visual Studio-Konvertierungs-Assistenten verwenden, um den ersten Konvertierungsschritt für die Projekt- und Web.config-Dateien durchzuführen. Später können Sie den Befehl In Webanwendung konvertieren verwenden, um die Dateien und die Struktur des Projekts zu aktualisieren.

Aktualisieren der .NET Framework-Version des Projekts. Sie müssen die .NET Framework-Version des Projekts entweder auf .NET Framework 2.0 SP1 oder .NET Framework 3.5 aktualisieren. Diese Aktualisierung der .NET Framework-Version ist erforderlich, da Visual Studio 2008 ältere Versionen von .NET Framework nicht verwenden kann. Sie können diese Aktualisierung während der Projektkonvertierung durchführen, indem Sie den Konvertierungs-Assistenten verwenden. Alternativ dazu können Sie die .NET Framework-Version aktualisieren, nachdem Sie das Projekt konvertiert haben.

Hinweis:
Sie können die .NET Framework-Version eines Projekts auch manuell ändern. Öffnen Sie dazu in Visual Studio die Eigenschaftenseiten für das Projekt, klicken Sie auf die Registerkarte Anwendung, und wählen Sie dann eine neue Version aus der Liste Zielframework.

In dieser exemplarischen Vorgehensweise werden die folgenden Aufgaben veranschaulicht:

Öffnen des Visual Studio .NET-Projekts in Visual Studio 2008 und Erstellen einer Sicherung der Projektdateien
Aktualisieren der .NET Framework-Version, auf die dieses Projekt abzielt
Konvertieren der Projektdatei und der Web.config-Datei
Konvertieren von ASP.NET-Codedateien
Testen des konvertierten Projekts

Vorbereitungsmaßnahmen

Um die exemplarische Vorgehensweise nachzuvollziehen, benötigen Sie Folgendes:

Visual Studio 2008.
Ein Websiteprojekt, das in Visual Studio .NET 2002 oder 2003 erstellt wurde und ohne Fehler kompiliert und ausgeführt werden kann.

Konvertieren des Projekts und Aktualisieren der .NET Framework-Version

Zuerst öffnen Sie das Projekt in Visual Studio 2008, um die Konvertierung zu starten. Dies bietet Ihnen die Gelegenheit, das Projekt vor dem Konvertieren zu sichern.

Hinweis:
Es wird dringend empfohlen, eine Sicherungskopie des Projekts zu erstellen. Bei der Konvertierung wird mit den Originaldateien des Projekts gearbeitet. Diese Dateien können nicht wiederhergestellt werden, wenn die Konvertierung nicht erfolgreich ist.

So konvertieren Sie das Projekt und sichern die Dateien

Klicken Sie in Visual Studio 2008 im Menü Datei auf Öffnen, und klicken Sie auf Projekt.

Das Dialogfeld Projekt öffnen wird angezeigt.

Greifen Sie auf den Ordner zu, der die Projekt- oder Lösungsdatei für das Visual Studio .NET-Projekt enthält, markieren Sie die Datei, und klicken Sie auf Öffnen.

Hinweis:
Stellen Sie sicher, dass Sie das Projekt öffnen, indem Sie den Befehl Projekt öffnen verwenden. Wenn Sie den Befehl Website öffnen verwenden, wird das Projekt in das Websiteprojekt-Format konvertiert.

Der Konvertierungs-Assistent wird geöffnet und fordert Sie auf, vor dem Konvertieren des Projekts eine Sicherungskopie zu erstellen.

Klicken Sie auf Ja, um die Sicherungskopie zu erstellen.
Klicken Sie auf Durchsuchen, wählen Sie den Ordner aus, in dem die Sicherungskopie erstellt werden soll, und klicken Sie dann auf Weiter.

Klicken Sie auf Fertig stellen.

Die Sicherungskopie wird erstellt.

Hinweis:
Dies kann lange dauern, da der Konvertierungs-Assistent Dateien kopiert, ohne dass die Anzeige aktualisiert oder der Fortschritt angezeigt wird. Warten Sie, bis der Prozess beendet ist, bevor Sie fortfahren.

Nachdem die Konvertierung abgeschlossen ist, fordert Sie der Assistent auf, die .NET Framework-Zielversion für das Projekt zu aktualisieren.

Um die Aktualisierung auf .NET Framework 3.5 durchzuführen, klicken Sie auf Ja. Um das Projekt auf .NET Framework 2.0 SP1 zu aktualisieren, klicken Sie auf Nein.

Es wird empfohlen, das Kontrollkästchen aktiviert zu lassen. Dies bewirkt, dass alle Webelemente der Lösung aktualisiert werden.

Wenn Sie die Aktualisierung auf .NET Framework 3.5 durchführen, wird die Web.config-Datei des Projekts gleichzeitig mit der Projektdatei geändert.

Nachdem die Aktualisierung und Konvertierung abgeschlossen ist, wird eine Meldung angezeigt, dass Sie den ersten Schritt der Projektkonvertierung durchgeführt haben.
Klicken Sie auf OK.

Der Assistent zeigt Statusinformationen zur Konvertierung an.
Klicken Sie auf Schließen.

Testen des konvertierten Projekts

Nachdem die Konvertierung abgeschlossen ist, können Sie das Projekt testen, um sicherzustellen, dass es ausgeführt wird. Auf diese Weise können Sie auch Code im Projekt identifizieren, der aktualisiert werden muss.

So überprüfen Sie, ob das Projekt ausgeführt werden kann

Wenn Sie wissen, dass Änderungen erforderlich sind, damit der Code mit der neuen .NET Framework-Version ausgeführt werden kann, nehmen Sie diese Änderungen vor.
Klicken Sie im Menü Erstellen auf Erstellen.

Fehlende Verweise oder andere Kompilierungsfehler des Projekts werden im Fenster Fehlerliste angezeigt. In den meisten Fällen hängen die Probleme mit fehlenden Assemblyverweisen oder fehlerhaften dynamisch erstellten Typen zusammen.
Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf die Webseite, über die die Anwendung gestartet wird, und klicken Sie auf Als Startseite festlegen.
Klicken Sie im Menü Debuggen auf Debuggen starten.

Wenn das Debuggen nicht aktiviert ist, wird das Dialogfeld Debugging nicht aktiviert angezeigt. Wählen Sie die Option zum Hinzufügen einer Web.config-Datei, für die das Debuggen aktiviert ist, und klicken Sie auf OK.
Stellen Sie sicher, dass das konvertierte Projekt wie gewünscht ausgeführt wird.

Fahren Sie mit dem Konvertierungsprozess erst fort, nachdem alle Erstellungs- und Laufzeitfehler behoben sind.

Konvertieren von ASP.NET-Codedateien

ASP.NET-Webseitendateien und Benutzersteuerelement-Dateien in Visual Studio 2008, die das Code-Behind-Modell verwenden, verfügen über eine zugeordnete Designerdatei. Die Dateien, die Sie gerade konvertiert haben, weisen eine zugeordnete Code-Behind-Datei auf, aber keine Designerdatei. Deshalb besteht der nächste Schritt darin, Designerdateien zu generieren.

Hinweis:
Nur ASP.NET-Webseiten und -Benutzersteuerelemente, deren Code in einer separaten Codedatei enthalten ist, erfordern eine separate Designerdatei. Für Seiten, die Inlinecode ohne zugeordnete Codedatei aufweisen, wird keine Designerdatei generiert.

So konvertieren Sie ASP.NET-Codedateien

Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und klicken Sie dann auf In Webanwendung konvertieren.

Die Dateien werden konvertiert.
Stellen Sie sicher, dass die konvertierten Codedateien über eine Codedatei und eine Designerdatei verfügen.
Erstellen Sie das Projekt, und führen Sie es aus, um die Ergebnisse der Konvertierung zu überprüfen.