Sintassi delle direttive include del lato server
Aggiornamento: novembre 2007
Inserisce il contenuto di un file specificato in un file ASP.NET, comprese pagine Web (file aspx), file dei controlli utente (ascx) e file Global.asax.
<!-- #include file|virtual="filename" -->
Attributi
File
Il nome file è un percorso fisico dalla directory contenente il file con la direttiva #include. Questo percorso può essere relativo.Nota
Il file incluso può trovarsi nella stessa directory o in una sottodirectory; non può trovarsi invece in una directory di livello superiore a quella del file con la direttiva #include.
Virtual
Il nome file è un percorso virtuale da una directory virtuale del sito Web. Questo percorso può essere relativo.Nota
L'utilizzo di questa tecnica è consigliato a causa di potenziali modifiche del percorso fisico di un file.
Note
Il valore assegnato all'attributo File o Virtual deve essere racchiuso tra virgolette (""). Il file incluso viene elaborato prima dell'esecuzione di codice dinamico. È possibile utilizzare i file di inclusione per contenere un elemento qualsiasi che può essere testo statico (ad esempio un'intestazione di pagina comune oppure l'indirizzo di una società), blocchi di codice HTML, controlli o codice lato server comuni che uno sviluppatore intende inserire all'interno di altre pagine.
Nota
Sebbene sia comunque possibile utilizzare il tag #include ai fini del riutilizzo del codice (inserendo codice HTML, controlli o codice per il lato server comuni all'interno di un file da includere in altre pagine Web), l'approccio consigliato in ASP.NET consiste nell'utilizzare i controlli utente Web. I controlli utente forniscono un modello di programmazione orientato a oggetti e maggiori funzionalità rispetto al lato server. Per informazioni dettagliate, vedere Controlli utente ASP.NET.
È necessario che il tag #include sia racchiuso tra i delimitatori di commento HTML o XML, per evitare che venga interpretato come testo.
Esempio
Nell'esempio di codice riportato di seguito viene illustrato come utilizzare la sintassi delle direttive include del lato server per richiamare i file che creeranno un'intestazione e un piè di pagina in una pagina ASP.NET. Entrambi utilizzano percorsi relativi.
<html>
<body>
<!-- #Include virtual="/include/header.inc" -->
Here is the main body of the .aspx file.
<!-- #Include virtual="/include/footer.inc" -->
</body>
</html>
Vedere anche
Concetti
Cenni preliminari sulla sintassi delle pagine Web ASP.NET