Partager via

Syntaxe de directive Include côté serveur

  • Article

Mise à jour : novembre 2007

Insère le contenu d'un fichier spécifié dans un fichier ASP.NET, y compris les pages Web (fichiers .aspx), les fichiers de contrôle utilisateur (fichiers .ascx) et les fichiers Global.asax.

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

Attributs

  • File
    Le nom de fichier correspond au chemin d'accès physique au répertoire contenant le fichier avec la directive #include. Ce chemin peut être relatif.

    Remarque :

    Le fichier inclus peut figurer dans le même répertoire ou dans un sous-répertoire ; il ne peut pas se trouver dans un répertoire au-dessus du fichier avec la directive #include.

  • Virtual
    Le nom de fichier correspond au chemin virtuel jusqu'au répertoire virtuel de votre site Web. Ce chemin peut être relatif.

    Remarque :

    Cette technique est recommandée à cause des changements potentiels dans le chemin d'accès physique à un fichier.

Notes

La valeur affectée à l'attribut File ou Virtual doit être entourée de guillemets (" "). Le fichier inclus est traité avant l'exécution de tout code dynamique. Les fichiers Include peuvent être utilisés pour contenir un contenu varié, depuis un texte statique (un en-tête de page commun ou une adresse de société) à du code côté serveur commun, des contrôles ou des blocs de balisage HTML qu'un développeur souhaite insérer dans d'autres pages.

Remarque :

Bien qu'il soit toujours possible d'utiliser les balises #include afin de pouvoir réutiliser le code (en plaçant du code côté serveur commun, des contrôles ou des balises HTML dans un fichier à inclure dans d'autres pages Web), l'approche par défaut dans ASP.NET consiste à utiliser de préférence des contrôles utilisateur Web. Les contrôles utilisateur fournissent un modèle de programmation orientée objet et des fonctionnalités beaucoup plus complètes que les directives Include côté serveur (SSI, Server-Side Include). Pour plus d'informations, consultez Contrôles utilisateur ASP.NET.

La balise #include doit être entourée par des délimiteurs de commentaire HTML ou XML pour éviter d'être interprétée comme du texte littéral.

Exemple

L'exemple de code suivant montre comment utiliser la syntaxe d'une directive Include côté serveur pour appeler des fichiers qui créeront un en-tête et un pied de page sur une page ASP.NET. Tous deux utilisent des chemins relatifs.

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

Voir aussi

Concepts

Vue d'ensemble de la syntaxe des pages Web ASP.NET

Autres ressources

Contrôles utilisateur ASP.NET