Exemplarische Vorgehensweise: Konvertieren eines Visual Studio 2005-Websiteprojekts in ein Visual Studio 2008-Webanwendungsprojekt

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird beschrieben, wie Sie ein Visual Studio 2005-Websiteprojekt in ein Visual Studio 2008-Webanwendungsprojekt konvertieren. Das Visual Studio 2008-Webanwendungsprojektmodell entspricht dem Visual Studio 2005-Webanwendungsprojektmodell. Dieses Feature wurde in .NET Framework 2.0 SP1 eingeführt. Weitere Informationen zu Webanwendungsprojekten finden Sie unter Übersicht über Webanwendungsprojekte

Hinweis:

Wenn die Website auf Microsoft ASP.NET AJAX basiert, erfordert der Konvertierungsprozess zusätzliche Schritte, die über diese exemplarische Vorgehensweise hinausgehen. Weitere Informationen finden Sie unter Gewusst wie: Aktualisieren eines ASP.NET AJAX 1.0-Webprojekts auf .NET Framework 3.5.

Diese exemplarische Vorgehensweise enthält die folgenden Aufgaben:

  • Öffnen der Visual Studio 2005-Website in Visual Studio 2008

  • Aktualisieren der .NET Framework-Version, auf die dieses Projekt abzielt

  • Erstellen eines neuen Visual Studio 2008-Webanwendungsprojekts

  • Kopieren der Visual Studio 2005-Websitedateien in das neue Visual Studio 2008-Webanwendungsprojekt.

  • Konvertieren von ASP.NET-Codedateien

  • Testen des konvertierten Projekts

Vorbereitungsmaßnahmen

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

  • Visual Studio 2008.

  • Eine Website, die in Visual Studio 2005 erstellt wurde und bei deren Kompilierung und Ausführung keine Fehler auftreten.

Konvertieren der Website

Öffnen Sie zuerst die Website in Visual Studio 2008, um die Konvertierung zu starten.

So konvertieren Sie die Website

  1. Klicken Sie in Visual Studio 2008 im Menü Datei auf Öffnen und dann auf Website.

    Das Dialogfeld Website öffnen wird angezeigt.

  2. Navigieren Sie zu dem Ordner, der die Websitedateien enthält, und klicken Sie auf Öffnen.

    Visual Studio 2008 fordert Sie auf, die .NET Framework-Zielversion für das Projekt zu aktualisieren.

  3. Um die Aktualisierung auf .NET Framework 3.5 durchzuführen, klicken Sie auf Ja.

    Hinweis:

    Sie können die .NET Framework-Zielversion auch später manuell ändern, indem Sie die Projekteigenschaftenseiten verwenden.

Testen der konvertierten Website

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 die Visual Studio 2005-Website kompiliert und ausgeführt wird

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

  2. Klicken Sie im Menü Erstellen auf Website erstellen.

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

    Ggf. wird auch das Dialogfeld Skriptdebugging deaktiviert angezeigt. Dies weist darauf hin, dass in Internet Explorer das Skriptdebugging deaktiviert ist. Um das Debuggen für Clientskript zu aktivieren, befolgen Sie die Anweisungen im Dialogfeld.

    Klicken Sie auf Ja, um mit dem Debuggen fortzufahren.

  4. Stellen Sie sicher, dass das Projekt wie gewünscht ausgeführt wird.

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

  5. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen des Projekts, und klicken Sie dann auf Eigenschaften.

  6. Klicken Sie auf die Registerkarte Verweise.

  7. Notieren Sie sich die Verweise, die im Projekt erforderlich sind.

    Wenn Sie im nächsten Abschnitt ein neues Projekt erstellen, müssen Sie sicherstellen, dass alle Verweise in diesem Projekt auch im neuen Projekt vorhanden sind.

Erstellen eines Visual Studio 2008-Webanwendungsprojekts

Sie können jetzt ein Visual Studio 2008-Webanwendungsprojekt erstellen, das Sie als Ziel der Konvertierung verwenden.

So erstellen Sie ein Visual Studio 2008-Webanwendungsprojekt

  1. Klicken Sie in Visual Studio 2008 im Menü Datei auf Neu und dann auf Projekt.

    Hinweis:

    Sie erstellen ein Webanwendungsprojekt als Visual Studio-Projekt, nicht als Website.

    Das Dialogfeld Neues Projekt wird angezeigt.

  2. Wählen Sie unter Projekttypen die Option Web.

  3. Wählen Sie die Programmiersprache aus, die Sie für das Projekt verwenden möchten.

  4. Wählen Sie unter Vorlagen die Option ASP.NET-Webanwendung.

  5. Geben Sie für das Projekt einen Namen, Speicherort und Projektmappennamen ein, und wählen Sie in der Liste Projektmappe die Option Neue Projektmappe erstellen aus.

    Hinweis:

    Erstellen Sie das Projekt in einem Ordner, der von der zu konvertierenden Visual Studio 2005-Website getrennt ist. Dies vereinfacht den Konvertierungsprozess.

  6. Wählen Sie in der Liste mit den .NET Framework-Versionen die .NET Framework-Version aus, bei der es sich um die Zielversion der ursprünglichen Konvertierung handelt.

  7. Klicken Sie auf OK.

    Die vorhandene Website wird geschlossen, und das neue Webanwendungsprojekt wird erstellt.

  8. Löschen Sie die Dateien Default.aspx und Web.config, die zusammen mit dem neuen Projekt erstellt werden.

  9. Erweitern Sie im Projektmappen-Explorer den Knoten Verweise, und vergleichen Sie die Liste der Standardverweise mit den Verweisen, die im zu konvertierenden Projekt erforderlich waren.

  10. Falls zusätzliche Verweise benötigt werden, klicken Sie mit der rechten Maustaste auf den Knoten Verweise, klicken Sie auf Verweis hinzufügen, und erstellen Sie dann im Dialogfeld Verweis hinzufügen die erforderlichen Verweise.

Kopieren von Dateien in das Webanwendungsprojekt

Sie können die Projektdateien aus dem alten Projekt jetzt in das neue Webanwendungsprojekt kopieren.

So kopieren Sie die Datei aus dem alten Projekt in das Webanwendungsprojekt

  1. Navigieren Sie in Windows-Explorer zu dem Ordner, der die Dateien des Visual Studio 2005-Websiteprojekts enthält.

  2. Wählen Sie die Dateien und die Ordner aus, die Sie dem neuen Projekt hinzufügen möchten, und kopieren Sie diese.

  3. Klicken Sie im neuen Visual Studio-Projekt im Projektmappen-Explorer mit der rechten Maustaste auf den Projektknoten, und klicken Sie dann auf Einfügen, um die kopierten Dateien dem neuen Projekt hinzuzufügen.

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

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

    Die Dateien werden konvertiert.

  2. Stellen Sie sicher, dass die konvertierten Codedateien über eine Codedatei und eine Designerdatei verfügen.

Testen des Webanwendungsprojekts

Nachdem Sie die Konvertierung von Dateien abgeschlossen haben, können Sie das Projekt testen, um sicherzustellen, dass es korrekt als Webanwendungsprojekt ausgeführt wird.

So erstellen Sie das konvertierte Projekt und führen es aus

  1. Klicken Sie im Menü Erstellen auf Erstellen, um die Anwendung zu kompilieren.

    Fehlende Verweise oder andere Probleme bei der Kompilierung des Projekts werden im Fenster Fehlerliste angezeigt.

  2. Führen Sie das Projekt aus.

  3. Stellen Sie sicher, dass das konvertierte Projekt wie gewünscht ausgeführt wird.

Nächste Schritte

Wenn Sie ein Visual Studio 2005-Websiteprojekt, das AJAX-Features enthält, in Visual Studio 2008 konvertieren möchten, ist der Prozess ähnlich. Es sind jedoch zusätzliche Schritte erforderlich. Führen Sie nach dem Konvertieren des Visual Studio-Projekts die Schritte aus, die unter Gewusst wie: Aktualisieren eines ASP.NET AJAX 1.0-Webprojekts auf .NET Framework 3.5 beschrieben sind.

Es kann auch sein, dass Sie andere Arten von Projekten aus älteren Visual Studio-Versionen in Visual Studio 2008 konvertieren möchten. Weitere Informationen finden Sie unter Übersicht: Konvertieren von Visual Studio-Websites und -Projekten in Visual Studio 2008.

Siehe auch

Aufgaben

Gewusst wie: Aktualisieren eines ASP.NET AJAX 1.0-Webprojekts auf .NET Framework 3.5

Konzepte

Übersicht: Konvertieren von Visual Studio-Websites und -Projekten in Visual Studio 2008

.Verwenden von .NET Framework für Websites

Migrieren und Konvertieren von ASP.NET-Websites