Sdílet prostřednictvím

Syntaxe serverové direktivy Include

  • Článek

Vloží obsah zadaného souboru do souboru aplikace technologie ASP.NET, včetně Webových stránek (soubory ASPX), uživatelských ovládacích prvků (soubory ASCX) a souborů global.asax.

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

v případě vícehodnotových atributů

  • File
    Název souboru je fyzická cesta z adresáře obsahujícího soubor s direktivou #include. Tato cesta může být relativní.

    PoznámkaPoznámka

    Začleněný soubor může být ve stejném adresáři nebo v podadresáři. Nemůže být v adresáři o úroveň výše, než je soubor s direktivou #include.

  • Virtual
    Název souboru je virtuální cesta z virtuálního adresáře vaší webové stránky. Tato cesta může být relativní.

    PoznámkaPoznámka

    Tato technika se doporučuje z důvodu možných změn ve fyzická cestě k souboru.

Poznámky

Hodnota přiřazená atributu File nebo Virtual musí být uzavřena v uvozovkách (""). Začleněný soubor je zpracován před provedením jakéhokoli dynamického kódu. Vložené soubory mohou obsahovat cokoli od statického textu (například společnou hlavičku stránky nebo adresu společnosti), až po společný kód na straně serveru, ovládací prvky nebo bloky značek jazyka HTML, které chce vývojář vložit v rámci jiných stránek.

PoznámkaPoznámka

Ačkoli můžete nadále používat značku #include pro účely opětovného použití kódu (jeho umístěním společného kódu, ovládacích prvků nebo značek jazyka HTML do souboru na straně serveru pro vložení do jiných webových stránek), je častěji upřednostňován přístup použití webových uživatelských ovládacích prvků.Uživatelské ovládací prvky poskytují objektově orientovaný model programování a daleko lepší funkcionalitu než vkládání na straně serveru.Další informace naleznete v tématu Uživatelské ovládací prvky technologie ASP.NET.

Značka #include musí být uzavřena mezi oddělovači komentáře jazyka HTML nebo XML, aby se zabránilo interpretaci jako čistého textu.

Příklad

Následující příklad kódu ukazuje možné použití syntaxe direktivy include na straně serveru k vyvolání souborů, které vytvoří hlavičku a zápatí stránky technologie ASP.NET. Oba používají relativní cesty.

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

Viz také

Koncepty

Přehled syntaxe webová stránky technologie ASP.NET

Další zdroje

Uživatelské ovládací prvky technologie ASP.NET