Exemplarische Vorgehensweise: Konvertieren eines Visual Studio .NET 2003-Webprojekts in ein Visual Studio-Webanwendungsprojekt

  • Artikel

Aktualisiert: November 2007

Wenn Sie ein Visual Studio .NET 2003-Webprojekt in ein Visual Studio 2008-Webanwendungsprojekt konvertieren, können Sie Features von Visual Studio 2008 nutzen. Dazu gehören Umgestaltung, Klassendiagramme, Testentwicklung und Generika. Durch das Modell des Webanwendungsprojekts werden zudem alle Funktionen von ASP.NET ab Version 2.0 verfügbar gemacht. Hierzu gehören Masterseiten, Datensteuerelemente, Mitgliedschaft und Anmeldesteuerelemente, Rollenverwaltung, Webparts, Personalisierung, Websitenavigation und Designs.

Das Visual Studio 2008-Webanwendungsprojektmodell ähnelt dem Projektmodell, das für Visual Studio .NET 2003-Anwendungen verfügbar ist. Dies kann bei der Konvertierung von Visual Studio .NET 2003-Webprojekten in Visual Studio 2008-Projekte nützlich sein. Weitere Informationen über neue Features finden Sie unter Neues in ASP.NET und Webentwicklung.

Hinweis:

Sie können ASP.NET-Webanwendungsprojekte mit Visual Studio oder Visual Web Developer Express Edition erstellen.

In dieser exemplarischen Vorgehensweise wird beschrieben, wie ein vorhandenes Visual Studio .NET 2003-Webprojekt in eine Visual Studio 2008-Webanwendung konvertiert wird. Das Webanwendungsprojektmodell basiert auf dem gleichen konzeptionellen Ansatz wie Webprojekte in Visual Studio .NET 2003. Dazu gehören eine Projektdatei zum Ein- und Ausschließen von Dateien sowie die Kompilierung in eine einzelne Assembly. Weitere Informationen finden Sie unter Webprojektkonvertierung aus Visual Studio .NET.

Hinweis:

Um eine mit Microsoft Office FrontPage 2003 erstellte Website in ein Webanwendungsprojekt zu konvertieren, müssen Sie die FrontPage-Website zunächst in ein Visual Studio 2008-Websiteprojekt umwandeln. Konvertieren Sie dann das Websiteprojekt in ein Webanwendungsprojekt. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Konvertieren eines Websiteprojekts in ein Webanwendungsprojekt in Visual Studio.

In dieser exemplarischen Vorgehensweise werden u. a. die folgenden Aufgaben veranschaulicht:

  • Öffnen und Überprüfen des Visual Studio .NET 2003-Webprojekts

  • Sichern des Visual Studio .NET 2003-Webprojekts

  • Konvertieren des Visual Studio .NET 2003-Webprojekts für Visual Studio 2008

  • Überprüfen des Webanwendungsprojekts in Visual Studio 2008

  • Konvertieren von Code-Behind-Klassen in partielle Klassen

  • Untersuchen und Beheben von XHTML-Kompatibilitätsproblemen

Vorbereitungsmaßnahmen

Für die Durchführung dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

  • Visual Studio .NET 2003

  • Visual Studio 2008 oder Visual Studio 2005 mit Service Pack 1 (SP1) bzw. Visual Web Developer Express Edition

  • .NET Framework Version 2.0

Öffnen und Überprüfen des Visual Studio .NET 2003-Webprojekts

Bevor Sie ein Projekt konvertieren, sollten Sie überprüfen, ob es ordnungsgemäß funktioniert. Dies verhindert Fehler bei der Konvertierung.

So öffnen und überprüfen Sie das Visual Studio .NET 2003-Webprojekt

  1. Öffnen Sie Visual Studio .NET 2003.

  2. Klicken Sie im Menü Datei auf Datei öffnen, und wählen Sie anschließend die SLN-Datei der Projektmappe aus, die Sie überprüfen möchten, indem Sie den Dateinamen eingeben oder zur Datei navigieren.

    Hinweis:

    In Visual Studio .NET 2003 sind die Dateien, auf denen das Projekt basiert, in einer Projektmappendatei (.sln) enthalten.

  3. Klicken Sie im Menü Projekt auf Projektmappe erstellen.

  4. Klicken Sie im Menü Debuggen auf Starten.

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

Sichern des Visual Studio .NET 2003-Webprojekts

Es wird empfohlen, die Visual Studio .NET 2003-Projektmappe und die Projektdateien vor der Konvertierung zu sichern. Falls Konvertierungsprobleme auftreten, kann auf diese Weise die Visual Studio .NET 2003-Projektmappe wiederhergestellt werden.

Sie können das Projekt sichern, indem Sie es in Visual Studio .NET 2003 kopieren.

So sichern Sie das Visual Studio .NET 2003-Webprojekt vor der Konvertierung

  1. Öffnen Sie Visual Studio .NET 2003.

  2. Klicken Sie im Menü Datei auf Datei öffnen, und wählen Sie anschließend die SLN-Datei der Projektmappe aus, die Sie sichern möchten, indem Sie den Dateinamen eingeben oder zur Datei navigieren.

  3. Klicken Sie im Menü Projekt auf Projekt kopieren.

  4. Wählen Sie im Feld Projekt kopieren den EintragZielprojektordner aus.

  5. Wählen Sie eine Option für die Webzugriffsmethode aus. Sie können entweder FrontPage oder Dateifreigabe verwenden, um die Dateien zu kopieren.

  6. Aktivieren Sie die Option Alle Dateien im Quellprojektordner, und klicken Sie dann auf OK.

Konvertieren des Visual Studio .NET 2003-Webprojekts für Visual Studio 2008

Die Visual Studio .NET 2003-Projektmappe und die Projektdateien werden von Visual Studio 2008 in das Format Microsoft Build Engine (MSBuild) umgewandelt. Dies ist das Projektformat von Visual Studio 2008.

Bei der Konvertierung wird von Visual Studio 2008 eine XML-basierte Protokolldatei erstellt, die eine Zusammenfassung der Konvertierung mit Angabe eventueller Fehler enthält. Standardmäßig wird die Konvertierungsprotokolldatei im gleichen Verzeichnis wie die SLN-Datei gespeichert. Wenn beim Kompilieren des konvertierten Projekts Probleme auftreten sollten, können Sie die Konvertierungsprotokolldatei zu Hilfe nehmen.

So konvertieren Sie das Webprojekt in Visual Studio 2008

  1. Schließen Sie die Projektmappendatei in Visual Studio .NET 2003.

  2. Öffnen Sie Visual Studio 2008.

  3. Klicken Sie im Menü Datei auf Datei öffnen, und wählen Sie anschließend die SLN-Datei der Projektmappe aus, die Sie konvertieren möchten, indem Sie den Dateinamen eingeben oder zur Datei navigieren.

    Der Visual Studio-Konvertierungs-Assistent wird geöffnet.

  4. Klicken Sie auf Weiter, folgen Sie den Anweisungen des Assistenten, und klicken Sie zum Schluss auf Fertig stellen.

Überprüfen des Webanwendungsprojekts in Visual Studio 2008

Nachdem die Projektmappe und die Projektdateien in das Visual Studio 2008-Format konvertiert wurden, sollten Sie überprüfen, ob die Anwendung fehlerfrei funktioniert und erwartungsgemäß ausgeführt wird.

So überprüfen Sie das Webanwendungsprojekt in Visual Studio 2008

  1. Klicken Sie in Visual Studio 2008 im Menü Datei auf Datei öffnen, und wählen Sie anschließend die SLN-Datei der Projektmappe aus, die Sie überprüfen möchten, indem Sie den Dateinamen eingeben oder zur Datei navigieren.

  2. Klicken Sie im Menü Projekt auf Projektmappe erstellen.

  3. Klicken Sie im Menü Debuggen auf Starten.

  4. Stellen Sie sicher, dass das Webanwendungsprojekt erwartungsgemäß ausgeführt wird.

Häufige Fehler und Warnungen

Die häufigsten Fehlertypen oder Warnungen, die während des Konvertierungsprozesses auftreten können, sind die Folgenden:

  • Konflikte mit in .NET Framework Version 2.0 eingeführten Namen

  • Warnungen zu veralteten Membern

  • Probleme beim Ausführen der Webanwendung

Entfernen Sie zur Behebung von Namenskonflikten Mehrdeutigkeiten, indem Sie vorhandene Namen durch Angabe eines Namespaces vollständig qualifizieren. Sie können den Konflikt auch lösen, indem Sie die betroffenen Typen und Member umbenennen. Weitere Informationen zu Benennungskonflikten finden Sie unter Übersicht über die Migration zu ASP.NET 2.0 und in den Richtlinien zur Namespace-Benennung.

Wenn eine Warnung hinsichtlich veralteter Member angezeigt wird, wird in der Regel die Verwendung alternativer Member vorgeschlagen. In diesem Fall können Sie weiterhin die veralteten Member verwenden. Diese Member werden jedoch mit der nächsten Hauptversion von .NET Framework entfernt werden. Daher empfiehlt es sich, die Member bereits jetzt zu entfernen und durch die empfohlenen Alternativen zu ersetzen.

Wenn beim Ausführen der Webanwendung der Fehler angezeigt wird, dass die Auflistung eines Verzeichnisses abgelehnt wurde, unterstützt das virtuelle Verzeichnis der Webanwendung das Auflisten seines Inhalts möglicherweise nicht. Klicken Sie zum Beheben dieses Problems im Projektmappen-Explorer mit der rechten Maustaste auf die Startseite der Anwendung, und klicken sie dann auf Als Startseite festlegen. Damit stellen Sie sicher, dass bei der Ausführung der Anwendung die richtige Seite aufgerufen wird.

Konvertieren von Code-Behind-Klassen in partielle Klassen

Von Webanwendungsprojekten in Visual Studio 2008 werden partielle Klassen für den von Visual Studio generierten Code verwendet. Diese Klassen werden in einer separaten Datei der Code-Behind-Datei gespeichert. Standardmäßig erstellt der Konvertierungs-Assistent von Visual Studio 2008 keine *.designer.cs- oder *.designer.vb-Datei für Webseiten (ASPX-Dateien) oder Benutzersteuerelemente (ASCX-Dateien). Stattdessen ist der Code in Aussehen und Funktionsweise mit dem in Visual Studio .NET 2003 identisch.

Hinweis:

Der Visual Studio 2008-Konvertierungs-Assistent nimmt während der Konvertierung nur geringstmögliche Änderungen an den Codedateien vor. Dadurch wird eine reibungslose Konvertierung in ein Visual Studio 2008-Webanwendungsprojekt sichergestellt.

Sie können den Code im Visual Studio .NET 2003-Format beibehalten. In diesem Fall müssen Sie die Steuerungsfelddeklarationen in den Code-Behind-Dateien wie in Visual Studio .NET 2003 manuell aktualisieren. Um jedoch die Felddeklarationen in generiertem Code beibehalten zu können, sollten Sie die Seiten und Steuerelemente zur Verwendung des partiellen Klassenmodells aktualisieren. Partielle Klassen erleichtern die Organisation von generiertem Code und benutzerdefiniertem Code für die Code-Behind-Dateien. Weitere Informationen finden Sie unter Partial (Visual Basic) und partial (Typ) (C#-Referenz).

So konvertieren Sie den Code zur Verwendung des partiellen Klassenmodells

  1. Stellen Sie sicher, dass der Code fehlerfrei kompiliert wird.

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

    Dieser Befehl bewirkt, dass jede Seite und jedes Benutzersteuerelement im Projekt durchlaufen wird. Alle Steuerelementdeklarationen werden in eine .designer.cs- oder designer.vb-Datei verschoben. Außerdem werden dem Serversteuerelement-Markup in den AXPX- und ASCX-Dateien Ereignishandlerdeklarationen hinzugefügt.

    Hinweis:

    Der Befehl In Webanwendung konvertieren kann auf einzelne Seiten angewendet werden. Auf diese Weise können Sie zunächst auf einigen Seiten überprüfen, welche Auswirkungen der Befehl auf diese Seiten hat, bevor Sie ihn auf die gesamte Anwendung anwenden.

    Die Wirkung des Befehls In Webanwendung konvertieren lässt sich nicht rückgängig machen. Die beste Methode, Änderungen rückgängig zu machen, besteht darin, die Visual Studio 2008-Konvertierung mit einem gesicherten Visual Studio .NET 2003-Projekt wie oben beschrieben erneut auszuführen.

  3. Überprüfen Sie nach der Beendigung des Prozesses, ob im Fenster Aufgabenliste Konvertierungsfehler gemeldet werden.

  4. Wenn in der Aufgabenliste Fehler angezeigt werden, klicken Sie mit der rechten Maustaste auf die entsprechende Seite im Projektmappen-Explorer, und wählen Sie Code anzeigen und Codegenerierungsdatei anzeigen aus, um den Code zu untersuchen und Fehler zu beheben.

    Hinweis:

    Fehler und Warnungen, die im Fenster Aufgabenliste angezeigt werden, bleiben zwischen Visual Studio-Sitzungen erhalten. Nachdem Sie die im Fenster aufgelisteten Fehler behoben haben, können Sie Elemente aus der Aufgabenliste löschen.

  5. Kompilieren Sie das Projekt erneut, um sicherzustellen, dass keine Fehler auftreten.

Wenn Sie dem Webprojekt anschließend Seiten hinzufügen, wird von den Seiten automatisch die Vorlage für partielle Klassen verwendet. Weitere Informationen finden Sie unter Übersicht über die Migration zu ASP.NET 2.0.

Untersuchen und Beheben von XHTML-Kompatibilitätsproblemen

Standardmäßig generiert und überprüft Visual Studio 2008 XHTML-kompatibles Markup. Dadurch lassen sich Webanwendungen, die mit Standards kompatibel sind, leichter erstellen und Probleme im Zusammenhang mit dem browserspezifischen Rendern minimieren. In Visual Studio .NET 2003 wird standardmäßig kein XHTML-kompatibles Markup generiert. Daher kann es nach der Konvertierung einer Webanwendung für Visual Studio 2008 zu Validierungs- und Renderproblemen mit Seiten kommen, die in Visual Studio .NET 2003 erstellt wurden.

Hinweis:

Validierungsfehler dienen lediglich zu Informationszwecken und werden als Warnungen gekennzeichnet. Validierungsfehler verhindern nicht, dass eine Seite ausgeführt wird.

Wenn HTML-Validierungsfehler wie in Visual Studio .NET 2003 angezeigt werden sollen, ändern Sie die HTML-Validierungseinstellung von XHTML Transitional in Internet Explorer 6.0. Internet Explorer 6.0 war die Visual Studio .NET 2003-Standardeinstellung für die HTML-Validierung. Weitere Informationen finden Sie unter Gewusst wie: Auswählen eines Validierungsschemas für die HTML-Bearbeitung in Visual Web Developer.

Sie können auch der Projektdatei Web.config den folgenden Abschnitt hinzufügen, damit ASP.NET altes (nicht mit XHTML kompatibles) Markup aus Serversteuerelementen entfernt:

<system.Web>
  <xhtmlConformance mode="Legacy" />
</system.Web>

Dadurch wird verhindert, dass Seiten mit ASP.NET 1.1 geringfügig anders gerendert werden als mit ASP.NET 2.0. Beachten Sie, dass die xhtmlConformance-Modusänderung nur zum Beheben von Konvertierungsproblemen verwendet werden sollte. Wenn das Webanwendungsprojekt ordnungsgemäß ausgeführt wird, entfernen Sie die alte Konfigurationseinstellung. Weitere Informationen finden Sie unter ASP.NET und XHTML und Übersicht über die Migration zu ASP.NET 2.0.

Siehe auch

Aufgaben

Gewusst wie: Aktualisieren von in Visual Studio .NET 2002 oder 2003 erstellten Projekten

Konzepte

Webprojektkonvertierung aus Visual Studio .NET

Übersicht über die Migration zu ASP.NET 2.0

Codemodell für ASP.NET-Webseiten

ASP.NET und XHTML

Referenz

Partial (Visual Basic)

partial (Typ) (C#-Referenz)

Partielle Klassen und Methoden (C#-Programmierhandbuch)

Visual Studio-Konvertierungs-Assistent

Weitere Ressourcen

Richtlinien zur Namespace-Benennung