Serverseitige Includedirektiven – "Global.asax"

Direktiven zum Einfügen des Inhalts von Dateien können sowohl in Global.asax als auch in einer beliebigen ASP.NET-Anwendungsdatei verwendet werden. Eine #include-Direktive kann den unformatierten Inhalt einer angegebenen Datei in eine ASP.NET-Anwendungsdatei einfügen. Die Syntax entspricht der eines HTML-Kommentartags und sieht wie folgt aus:

<!-- #include pathtype = filename -->

Parameter

• pathtype
  Der Pfadtyp der durch den filename-Parameter angegebenen Datei.
• filename
  Der Name der Datei, deren Inhalt in die ASP.NET-Anwendungsdatei eingefügt wird. Der filename-Parameter muss die Dateinamenerweiterung enthalten. Darüber hinaus müssen der Dateiname und die Erweiterung in Anführungszeichen gesetzt werden.

Attribute

Beim Pfadtyp kann es sich um eines der folgenden zwei Attribute handeln.

• file
  Gibt an, dass der filename-Parameter ein relativer Pfad zu dem Verzeichnis ist, in dem sich die Datei mit der #include-Direktive befindet. Die Datei, deren Inhalt eingefügt wird, kann sich in demselben Verzeichnis oder in einem Unterverzeichnis befinden. Sie kann sich nicht in einem Verzeichnis über der Datei mit der #include-Direktive befinden.
• virtual
  Gibt an, dass der filename-Parameter ein vollständiger virtueller Pfad zu einem virtuellen Verzeichnis auf der Website ist.

Hinweise

Die eingefügte Datei wird verarbeitet, bevor dynamischer Code ausgeführt wird. Das die #include-Direktive enthaltende Tag muss in HTML- bzw. XML-Kommentartrennzeichen eingeschlossen werden, damit es nicht als statischer Text interpretiert wird.

Beispiel

Das folgende Beispiel veranschaulicht, wie eine Datei mit der Bezeichnung MyHeader.inc auf einer Web Forms-Seite eingefügt wird.

<!-- #include File = "MyHeader.inc" -->

Siehe auch

Syntax von "Global.asax"