Gewusst wie: Generieren von festen Namen mit dem ASP.NET-Kompilierungstool

  • Artikel

Aktualisiert: November 2007

Das ASP.NET-Kompilierungstool (Aspnet_compiler.exe) verwendet Assemblynamen, die zur Kompilierungszeit generiert und bei jeder folgenden Kompilierung neu generiert werden. Die generierten Assemblynamen können problemlos für als Ganzes bereitgestellte Websites verwendet werden. Für Websites, die Aktualisierungen bestimmter Abschnitte der Website veröffentlichen müssen, ohne die ganze Website erneut bereitzustellen, sind sie nicht geeignet.

Sie können den -fixednames-Schalter verwenden, um mit dem ASP.NET-Kompilierungstool feste Assemblynamen zu generieren. Wenn Sie den -fixednames-Schalter verwenden, führt das ASP.NET-Kompilierungstool folgende Schritte aus:

  • Erstellen einer Assembly für jede ASPX-Seite in der Anwendung. Begrenzen Sie die Anzahl der Seiten in der Anwendung, um die Anzahl der generierten Assemblys zu verringern.

  • Verwenden Sie den virtuellen Pfad der Seite als Namen für die Assembly der Seite. Wenn die Länge des virtuellen Pfads die Begrenzung des Betriebssystems für die Länge von Dateinamen überschreitet, verwendet das Tool stattdessen einen Hash des virtuellen Pfads.

  • Kompilieren der Dateien in Verzeichnissen der obersten Ebene, z. B. im Verzeichnis App_Code, zu einer einzelnen Assembly (wie bei der Standardkompilierung).

Für das Verfahren in diesem Thema werden die Schalter und Parameter von Aspnet_compiler.exe verwendet. Weitere Informationen finden Sie unter ASP.NET-Kompilierungstool (Aspnet_compiler.exe).

Weitere Informationen über die Vorkompilierung finden Sie unter Vorkompilieren einer ASP.NET-Website.

So kompilieren Sie eine Website mit festen Assemblynamen

  1. Öffnen Sie ein Befehlsfenster, und navigieren Sie zu dem Ordner, der .NET Framework enthält.

    .NET Framework ist am folgenden Speicherort installiert.

    %windir%\Microsoft.NET\Framework\version

  2. Führen Sie den Befehl aspnet_compiler aus, indem Sie an der Eingabeaufforderung Folgendes eingeben:

    aspnet_compiler -v virtualPathtargetPath -fixednames

    Der virtualPath-Parameter gibt den virtuellen Pfad der Internetinformationsdienste (IIS) für die Website an. Der targetPath-Parameter ist ein physischer Pfad zum Zielverzeichnis.

    Wenn es sich bei der Website nicht um eine IIS-Anwendung handelt und dementsprechend kein Eintrag in der IIS-Metabasis vorhanden ist, geben Sie an der Eingabeaufforderung Folgendes ein:

    aspnet_compiler -p physicalOrRelativePath -v / targetPath -fixedNames

    In diesem Fall bezieht sich der physicalOrRelativePath-Parameter auf den vollqualifizierten Verzeichnispfad, der die Dateien der Website enthält, oder auf einen relativ zum aktuellen Verzeichnis angegebenen Pfad. Der Punktoperator (.) ist für den physicalOrRelativePath-Parameter zulässig. Der -v-Schalter gibt einen Stamm an, mit dessen Hilfe der Compiler Verweise auf den Anwendungsstamm (z. B. mit einem Tildeoperator, ~) auflöst. Wenn Sie für den -v-Schalter den Wert / angeben, verwendet der Compiler zum Auflösen des Pfads den physischen Pfad als Stamm.

    Der targetPath-Parameter ist ein physischer Pfad zum Zielverzeichnis.

Siehe auch

Aufgaben

Gewusst wie: Vorkompilieren von ASP.NET-Websites für die Bereitstellung

Weitere Ressourcen

Vorkompilieren einer ASP.NET-Website