Konvertierung von Webprojekteinstellungen

  • Artikel

Aktualisiert: November 2007

Da in Visual Studio keine Projektdateien zur Webentwicklung verwaltet werden, müssen relevante Projekt- und Projektmappeneinstellungen über einen Konvertierungsprozess in ein Visual Studio-Format umgewandelt werden. Beispielsweise werden bei der Konvertierung einige Projekteinstellungen in die Datei Web.config verschoben. Diese wurde in Microsoft Visual Studio 2005 erweitert, damit in ihr mehr Informationen gespeichert werden können als in früheren Versionen von Visual Studio .NET.

Viele der Einstellungen in Visual Studio .NET können für Visual Studio 2005 nicht übernommen werden. Sie werden daher nicht konvertiert. Zum Beispiel gelten Projekteinstellungen für den Webzugriffsmodus (Dateifreigabe oder FrontPage) oder für Designerstandards nicht für Visual Studio. Sie werden also nicht konvertiert. Projekteinstellungen, die auf Standardwerte festgelegt sind, werden ebenfalls nicht konvertiert. Das heißt, dass Visual Studio keine neuen Einstellungen mit Standardwerten vornimmt.

Projekte mit mehreren Konfigurationen

Wenn ein Projekt mehrere Konfigurationen (Debugkompilierung, Freigabekompilierung usw.) enthält, folgt die Konvertierung der folgenden Logik:

  • Wenn das Projekt nur Debug- und Freigabekonfigurationen enthält, wird die Debugkonfiguration in Visual Studio 2005 konvertiert.

  • Wenn zusätzliche Konfigurationen vorhanden sind, werden Sie von Visual Studio zur Eingabe der Konfigurationseinstellungen aufgefordert, die in Visual Studio 2005 konvertiert werden sollen.

Verweise

Verweise auf Assemblys im Ordner Bin des Projekts müssen nicht konvertiert werden. Websites in Visual Studio übernehmen Codeverweise im Ordner Bin automatisch. Wenn das Projekt einen Verweis auf eine Assembly im globalen Assemblycache enthält, wird der Verweis im folgenden Format in die Datei Web.config verschoben.

<compilation>
  <assemblies>
    <add assembly="System.Messaging" />
  </assemblies>
</compilation>

Assemblyverweise werden nicht konvertiert, wenn bereits in ASP.NET ein Standardverweis auf die Assembly vorhanden ist (z. B. System.Drawing).

In Visual Studio .NET kann für Assemblys, auf die verwiesen wird (z. B. Assemblys, auf die von außerhalb der Projektmappe verwiesen wird, in der sich das Webprojekt befindet), die CopyLocal-Eigenschaft auf true festgelegt sein. Dadurch wird die Assembly, auf die verweisen wird, automatisch aktualisiert. In Visual Studio 2005 wird dieses Verhalten durch das Erstellen einer Aktualisierungsdatei im Ordner Bin ersetzt. Die Aktualisierungsdatei enthält den Pfad der externen Assembly, auf die verwiesen wird, und ihr Dateiname besteht aus dem Assemblynamen, an den die Erweiterung .refresh angefügt ist.

XML-Webverweise werden konvertiert, indem die WSDL-Datei in das Verzeichnis App_WebReferences kopiert wird. Die Dateien für den Webdienstproxy und die Verweiszuordnung sind in Visual Studio 2005 nicht erforderlich.

Konvertierung allgemeiner Einstellungen

In der folgenden Tabelle werden die Projekteinstellungen für Allgemeine Eigenschaften aufgelistet, und wie diese von der Konvertierung in Visual Studio behandelt werden.

Hinweis:

Sie können die aktuellen Werte für diese Einstellungen in Visual Studio anzeigen. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, klicken Sie auf Eigenschaften und dann auf Allgemeine Eigenschaften.

Einstellung

Konvertierungslogik

Allgemein

Einstellungen werden nicht konvertiert.

Webeinstellungen

Einstellungen werden nicht konvertiert.

Designerstandard

Einstellungen werden nicht konvertiert.

Verweispfad

Einstellungen werden nicht konvertiert.

Build (Visual Basic-Clientprojekte)

  • Option Explicit

    Wenn diese Einstellung auf false festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compilation explicit="false">

  • "Option Strict"

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compilation strict="true" />

  • Option Compare

    Wenn diese Einstellung auf Text festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler language="vb"

    compilerOptions="optioncompare:text" />

Importe (Visual Basic-Clientprojekte)

Importeinstellungen, die nicht bereits standardmäßig in ASP.NET importiert werden, werden in die Datei Web.config verschoben:

<pages>

<namespaces>

<add namespace="Namespace" />

</namespaces>

</pages>

Die Konvertierung hat nur Auswirkungen auf die Importeinstellungen für ASP.NET-Webseiten. Für Klassen im Verzeichnis App_Code müssen Sie die Importeinstellungen manuell hinzufügen.

Konvertierung von Konfigurationseinstellungen

Konfigurationseinstellungen für ein Projekt unterscheiden sich geringfügig, abhängig von der im Projekt verwendeten Programmiersprache. In der folgenden Tabelle wird, aufgeschlüsselt nach Sprache, aufgelistet, wie Konfigurationseinstellungen durch die Konvertierung in Visual Studio behandelt werden.

Hinweis:

Sie können die aktuellen Werte für diese Einstellungen in Visual Studio anzeigen. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf das Projekt, klicken Sie auf Eigenschaften und dann auf Konfigurationseigenschaften.

Konfigurationseinstellungen – Alle Sprachen

In der folgenden Tabelle werden die Projekteinstellungen für Konfiguration aufgelistet, die in allen Projekttypen angezeigt werden. Außerdem wird beschrieben, wie diese bei der Konvertierung in Visual Studio behandelt werden.

Einstellung

Konvertierungslogik

Debuggen

  • ASP-Debuggen aktivieren

    Einstellung wird nicht konvertiert.

  • ASP.NET-Debuggen aktivieren

    Einstellung wird nicht konvertiert.

  • Nicht verwaltetes Debuggen aktivieren

    Einstellung wird ohne Änderungen konvertiert.

  • SQL-Debuggen aktivieren

    Einstellung wird ohne Änderungen konvertiert.

  • Einstellungen für Startaktion

    Einstellungen werden für jeden Benutzer in einen clientseitigen Cache verschoben.

  • Befehlszeilenargumente

    Einstellung wird ohne Änderungen konvertiert.

  • Arbeitsverzeichnis

    Einstellung wird ohne Änderungen konvertiert.

  • Immer Internet Explorer verwenden

    Einstellung wird nicht konvertiert.

  • Remotedebuggen aktivieren

    Einstellung wird nicht konvertiert.

  • Remotedebugcomputer

    Einstellung wird nicht konvertiert.

Konfigurationseinstellungen – Visual Basic .NET

In der folgenden Tabelle werden die Projekteinstellungen für Konfiguration aufgelistet, die in einem Visual Basic .NET-Projekt angezeigt werden. Außerdem wird beschrieben, wie diese bei der Konvertierung in Visual Studio behandelt werden.

Einstellung

Konvertierungslogik

Build

  • Ausgabepfad

    Einstellung wird nicht konvertiert.

  • Debuginformationen generieren

    Einstellung wird in die Datei Web.config verschoben:

    <compilation debug="true|false" />

  • Für COM-Interop registrieren

    Einstellung wird nicht konvertiert.

  • Buildwarnungen aktivieren (Visual Basic-Clientprojekte)

    Einstellung wird nicht konvertiert. Buildwarnungen sind in Visual Studio .NET immer aktiviert.

  • Compilerwarnungen als Fehler behandeln (Visual Basic-Clientprojekte)

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="vb"

    compilerOptions="warnaserror+" />

  • DEBUG-Konstante definieren (Visual Basic-Clientprojekte)

    Einstellung wird in die Datei Web.config verschoben:

    <compiler

    language="vb"

    compilerOptions="define:Debug" />

  • TRACE-Konstante definieren (Visual Basic-Clientprojekte)

    Einstellung wird in die Datei Web.config verschoben:

    <compiler

    language="vb"

    compilerOptions="define:Trace" />

  • Benutzerdefinierte Konstanten (Visual Basic-Clientprojekte)

    Einstellung wird in die Datei Web.config verschoben:

    <compiler

    language="vb"

    compilerOptions="define:<list>" />

  • XML-Dokumentation

    Wenn diese Einstellung festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler language="c#"

    compilerOptions="doc:<filepath>" />

  • Bedingte Kompilierungskonstanten

    Einstellung wird in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="d:<symbols>" />

  • Code optimieren

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="o" />

  • Auf arithmetischen Über-/Unterlauf überprüfen

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="checked+" />

  • Unsichere Codeblöcke zulassen

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="unsafe+" />

  • Warnstufe

    Wenn diese Einstellung nicht auf 4 festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="w:<level>" />

  • Warnungen als Fehler behandeln

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler language="c#"

    compilerOptions="warnaserror+" />

  • Bestimmte Warnungen unterdrücken

    Wenn diese Einstellung festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="nowarn:<warning list>" />

Optimierungen (Visual Basic-Clientprojekte)

  • Überprüfungen auf Ganzzahlüberlauf entfernen

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="vb"

    compilerOptions="removeintchecks+" />

  • Aktivierte Optimierungen

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="vb"

    compilerOptions="optimize+" />

  • Inkrementellen Build aktivieren

    Einstellung wird nicht konvertiert.

  • DLL-Basisadresse

    Einstellung wird nicht konvertiert.

Konfigurationseinstellungen – C#

In der folgenden Tabelle werden die Projekteinstellungen für Konfiguration aufgelistet, die in einem C#-Projekt angezeigt werden. Außerdem wird beschrieben, wie diese bei der Konvertierung in Visual Studio behandelt werden.

Einstellung

Konvertierungslogik

Build

  • Bedingte Kompilierungskonstanten

    Einstellung wird in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="d:<symbols>" />

  • Code optimieren

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="o" />

  • Auf arithmetischen Über-/Unterlauf überprüfen

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="checked+" />

  • Unsichere Codeblöcke zulassen

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="unsafe+" />

  • Warnstufe

    Wenn diese Einstellung nicht auf 4 festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="w:<level>" />

  • Warnungen als Fehler behandeln

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler language="c#"

    compilerOptions="warnaserror+" />

  • Bestimmte Warnungen unterdrücken

    Wenn diese Einstellung festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="nowarn:<warning list>" />

  • Ausgabepfad

    Einstellung wird nicht konvertiert.

  • XML-Dokumentation

    Wenn diese Einstellung festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler language="c#"

    compilerOptions="doc:<filepath>" />

  • Debuginformationen generieren

    Einstellung wird in die Datei Web.config verschoben:

    <compilation debug="true|false" />

  • Für COM-Interop registrieren

    Einstellung wird nicht konvertiert.

Erweitert

  • Inkrementeller Build

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="incr+" />

  • Basisadresse

    Einstellung wird nicht konvertiert.

  • Dateianordnung

    Wenn diese Einstellung nicht auf 4096 festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="filealign:<n>" />

  • "Mscorlib" nicht verwenden

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="c#"

    compilerOptions="nostdlib+" />

Konfigurationseinstellungen – J#

In der folgenden Tabelle werden die Projekteinstellungen für Konfiguration aufgelistet, die in einem Microsoft J# .NET-Projekt angezeigt werden. Außerdem wird beschrieben, wie diese von der Konvertierung in Visual Studio behandelt werden sollen.

Einstellung

Konvertierungslogik

Build

  • Bedingte Kompilierungskonstanten

    Einstellung wird in die Datei Web.config verschoben:

    <compiler

    language="j#"

    compilerOptions="d:<symbols>" />

  • Code optimieren

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="j#"

    compilerOptions="o" />

  • Warnstufe

    Wenn diese Einstellung nicht auf 4 festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="j#"

    compilerOptions="w:<level>" />

  • Warnungen als Fehler behandeln

    Wenn diese Einstellung auf true festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler language="j#"

    compilerOptions="warnaserror+" />

  • Bestimmte Warnungen unterdrücken

    Wenn diese Einstellung festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="j#"

    compilerOptions="nowarn:<warning list>" />

  • Ausgabepfad

    Einstellung wird nicht konvertiert.

  • Debuginformationen generieren

    Einstellung wird in die Datei Web.config verschoben:

    <compilation debug="true|false" />

  • Für COM-Interop registrieren

    Einstellung wird nicht konvertiert.

Erweitert

  • Basisadresse

    Einstellung wird nicht konvertiert.

  • Zusätzliche Optionen

    Wenn diese Einstellung festgelegt ist, wird sie in die Datei Web.config verschoben:

    <compiler

    language="j#"

    compilerOptions="<list of options>" />

Siehe auch

Konzepte

Webprojektkonvertierung aus Visual Studio .NET

Konvertierung von Webprojektmappen und Projektdateien