다음을 통해 공유


SharePoint용 애플리케이션 페이지 만들기

애플리케이션 페이지는 SharePoint 웹 사이트에서 사용하도록 설계된 ASP.NET 웹 페이지입니다. 애플리케이션 페이지는 특수한 유형의 ASP.NET 페이지입니다. 애플리케이션 페이지와 표준 ASP.NET 페이지의 주요 차이점은 애플리케이션 페이지에 SharePoint 마스터 페이지와 병합된 콘텐츠가 포함되어 있다는 점입니다. 마스터 페이지를 사용하면 애플리케이션 페이지가 사이트의 다른 페이지와 동일한 모양과 동작을 공유할 수 있습니다.

Visual Studio를 사용하면 디자이너를 사용하여 애플리케이션 페이지를 디자인할 수 있습니다. 디자이너는 마스터 페이지에 정의된 각 콘텐츠 자리 표시자에 대한 콘텐츠 영역을 표시합니다. 컨트롤을 이러한 콘텐츠 영역으로 끌어 애플리케이션 페이지를 디자인할 수 있습니다.

애플리케이션 페이지

애플리케이션 페이지는 서버의 모든 사이트에서 공유되는 반면 사이트 페이지는 하나의 사이트와 관련이 있습니다. 자세한 내용은 SharePoint 페이지 유형입니다.

기본적으로 SharePoint 사이트를 만들 때 표시되는 대부분의 페이지는 사이트 페이지입니다. SharePoint 페이지 라이브러리에 사이트 페이지를 추가할 수 있습니다. 사용자는 SharePoint Designer와 같은 도구를 사용하여 사이트 페이지를 사용자 지정할 수 있습니다. 사이트 페이지는 동적 웹 파트 및 웹 파트 영역과 같은 기능을 호스트할 수도 있습니다.

애플리케이션 페이지는 이러한 작업을 수행할 수 없습니다. 그러나 애플리케이션 페이지는 페이지에 사용자 지정 코드를 포함하려는 경우 만들 수 있는 가장 좋은 유형의 페이지입니다. 사이트 페이지에 사용자 지정 코드를 추가할 수 있지만 사용자가 SharePoint Designer와 같은 도구를 사용하여 페이지를 사용자 지정할 때 코드 실행이 중지됩니다.

비고

Visual Studio는 SharePoint 사이트의 사이트 페이지를 만드는 데 도움이 되는 템플릿을 제공하지 않습니다. 자세한 내용은 SharePoint 페이지 형식을 참조하세요.

애플리케이션 페이지 만들기

애플리케이션 페이지를 만들려면 SharePoint 프로젝트에 애플리케이션 페이지 항목을 추가합니다. 애플리케이션 페이지를 만들 때 Visual Studio는 프로젝트에 다음 폴더를 추가합니다.

폴더 Description
Layouts SharePoint 파일 시스템의 _layouts 가상 디렉터리에 매핑됩니다.
레이아웃 하위 폴더 애플리케이션 페이지를 구성하는 파일을 포함합니다. 기본적으로 이 폴더의 이름은 프로젝트와 같습니다. 언제든지 이 폴더의 이름을 바꿀 수 있습니다. 프로젝트를 실행하면 Visual Studio에서 이 폴더를 SharePoint 파일 시스템의 _layouts 가상 디렉터리에 배포합니다.

Visual Studio는 프로젝트에 다음 파일을 추가합니다.

File Description
ASP.NET 페이지 파일(.aspx) 페이지를 정의하는 XML 태그를 포함합니다.
애플리케이션 페이지 코드 파일 애플리케이션 페이지 뒤에 있는 코드를 포함합니다. 이 파일에 이벤트를 처리하는 코드를 추가합니다.
애플리케이션 페이지 디자이너 코드 파일 디자이너에서 생성한 코드를 포함합니다. 이 파일을 직접 편집하지 마세요.

애플리케이션 페이지 디자인 및 디버그

Visual Studio에서 디자이너 보기를 사용하여 애플리케이션 페이지의 콘텐츠를 디자인합니다. 이 디자이너는 프로젝트에서 애플리케이션 페이지를 두 번 클릭하거나 바로 가기 메뉴를 연 다음 열기를 선택하여 애플리케이션 페이지를 연 다음 편집기 아래쪽에 있는 디자인 단추를 선택하면 나타납니다.

비고

디자이너의 원본 보기에서만 페이지를 디자인할 수 있습니다. 디자이너의 디자인 보기는 애플리케이션 페이지에 사용할 수 없습니다.

Visual Studio에서 다른 SharePoint 프로젝트 항목을 디버그하는 것처럼 애플리케이션 페이지를 디버그할 수 있습니다. Visual Studio 디버거를 시작하면 Visual Studio에서 SharePoint 사이트를 엽니다.

애플리케이션 페이지를 보려면 애플리케이션 페이지의 위치(예: http:// Server_Name/_layouts/Project_Name/ApplicationPage1.aspx)로 수동으로 이동해야 합니다.

SharePoint 프로젝트를 디버그하는 방법에 대한 자세한 내용은 SharePoint 솔루션 문제 해결을 참조하세요.

마스터 페이지 선택

기본적으로 애플리케이션 페이지 항목은 프로젝트를 디버그하는 데 사용하는 사이트의 마스터 페이지를 참조합니다. 해당 페이지의 이름은 v4.master이며 SharePoint 사이트의 마스터 페이지 갤러리 에 나열된 페이지를 찾을 수 있습니다.

애플리케이션 Page 요소의 MasterPageFile 속성을 설정하여 애플리케이션 페이지에서 사용하는 마스터 페이지를 명시적으로 변경할 수 있습니다. (예: MasterPageFile="~/_layouts/applicationv4.master"). 실제로 SharePoint 서버에서 동적 마스터 페이지를 사용하도록 설정하지 않은 경우 이 특성을 설정해야 합니다. SharePoint의 마스터 페이지에 대한 자세한 내용은 마스터 페이지를 참조하세요.