다음을 통해 공유


서버측 Include 지시문 구문

[이 설명서는 미리 보기 전용이며, 이후 릴리스에서 변경될 수 있습니다. 비어 있는 항목은 자리 표시자로 포함됩니다.]

지정된 파일의 내용을 웹 페이지(.aspx 파일), 사용자 정의 컨트롤 파일(.ascx 파일), Global.asax 파일 등의 ASP.NET 파일에 삽입합니다.

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

특성

  • File
    파일 이름은#include 지시문이 있는 파일이 포함된 디렉터리의 실제 경로입니다. 이 경로는 상대적일 수 있습니다.

    참고

    포함된 파일은 동일한 디렉터리 또는 하위 디렉터리에 위치할 수 있지만, #include 지시문이 있는 페이지보다 상위 디렉터리에 위치할 수는 없습니다.

  • Virtual
    파일 이름은 웹 사이트의 가상 디렉터리의 가상 경로이며, 이 경로는 상대적일 수 있습니다.

    참고

    파일의 실제 경로가 변경될 수 있으므로 이 방법을 사용하는 것이 좋습니다.

설명

File 또는 Virtual 특성에 할당된 값은 따옴표("")로 묶어야 합니다. 포함된 파일은 다른 모든 동적 코드가 실행되기 전에 처리됩니다. 포함 파일은 정적 텍스트(예: 공용 페이지 머리글 또는 회사 주소)에서 공용 서버측 코드, 컨트롤 또는 HTML 태그 블록에 이르기까지 개발자가 다른 페이지에 삽입하려는 모든 요소를 포함하는 데 사용될 수 있습니다.

참고

다른 웹 페이지에 포함할 파일에 공용 서버측 코드, 컨트롤 또는 HTML 태그를 삽입하는 경우 #include 태그를 사용하여 코드를 재사용할 수도 있지만 ASP.NET에서는 웹 사용자 정의 컨트롤을 사용하는 것이 좋습니다.사용자 정의 컨트롤은 개체 지향 프로그래밍 모델을 제공하고 서버측 include에 비해 향상된 기능을 포함합니다.자세한 내용은 ASP.NET User Controls를 참조하십시오.

#include 태그는 리터럴 텍스트로 해석되지 않도록 HTML 또는 XML 주석 구분 기호로 묶어야 합니다.

예제

다음 코드 예제에서는 서버측 include 지시문 구문을 사용하여 ASP.NET 페이지에 머리글과 바닥글을 만드는 파일을 호출하는 방법을 보여 줍니다. 두 경로 모두 상대적 경로입니다.

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

참고 항목

개념

ASP.NET Web Page Syntax Overview

기타 리소스

ASP.NET User Controls