Freigeben über


Syntax für serverseitige Includedirektiven

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

Fügt den Inhalt einer angegebenen Datei in eine ASP.NET-Datei ein, z. B. Webseiten (ASPX-Dateien), Benutzersteuerelementdateien (ASCX-Dateien) und Dateien Global.asax.

<!-- #include file|virtual="filename" -->

Attribute

  • File
    Bei dem Dateinamen handelt es sich um einen physikalischen Pfad von dem Verzeichnis aus, das die Datei mit der #include-Direktive enthält. Dieser Pfad kann relativ sein.

    Hinweis

    Die eingefügte Datei kann sich im selben Verzeichnis oder in einem Unterverzeichnis befinden, nicht aber in einem der Datei mit der #include-Direktive übergeordneten Verzeichnis.

  • Virtual
    Der Dateiname ist ein virtueller Pfad von einen virtuellen Verzeichnis auf der Website. Dieser Pfad kann relativ sein.

    Hinweis

    Diese Technik wird wegen der potenziellen Änderungen am physikalischen Pfad zu einer Datei empfohlen.

Hinweise

Der dem File-Attribut oder dem Virtual-Attribut zugewiesene Wert muss in Anführungszeichen stehen ("") stehen. Die eingefügte Datei wird verarbeitet, bevor dynamischer Code ausgeführt wird. Includedateien können alles enthalten, was Sie in andere Seiten einfügen möchten, sei es statischer Text (z. B. ein herkömmlicher Seitenheader oder eine Unternehmensadresse), häufig wiederkehrender serverseitiger Code, Steuerelemente oder HTML-Markup-Blöcke.

Hinweis

Auch wenn Sie weiterhin das #include-Tag für die Wiederverwendung von Code verwenden können (indem sie häufigen serverseitigen Code, Steuerelemente oder HTML-Markup in einer Datei ablegen, um sie in andere Webseiten einzufügen), wird dennoch empfohlen, Webbenutzersteuerelemente zu verwenden.Benutzersteuerelemente stellen ein objektorientiertes Programmiermodell bereit und bieten ein höheres Maß an Funktionalität als serverseitige Includes.Ausführlichere Informationen finden Sie unter ASP.NET User Controls.

Das #include-Tag muss in HTML- oder XML-Kommentartrennzeichen eingeschlossen werden, damit es nicht als Literaltext interpretiert wird.

Beispiel

Das folgende Codebeispiel veranschaulicht, wie Sie mit der Syntax für serverseitige Includedirektiven Dateien aufrufen können, die einen Header und einen Footer auf einer ASP.NET-Seite erstellen. Bei beiden werden relative Pfade verwendet.

<html>
   <body>
      <!-- #Include virtual="/include/header.inc" -->
        Here is the main body of the .aspx file.
      <!-- #Include virtual="/include/footer.inc" -->
   </body>
</html>

Siehe auch

Konzepte

ASP.NET Web Page Syntax Overview

Weitere Ressourcen

ASP.NET User Controls