연습: 기본 사이트 정의 프로젝트 만들기

아티클
08/09/2011

이 연습에서는 일부 컨트롤이 있는 비주얼 웹 파트가 포함된 기본 사이트 정의를 만드는 방법을 보여 줍니다. 구분하기 쉽도록 사용자가 만든 비주얼 웹 파트에는 몇 개의 컨트롤만 있습니다. 하지만 추가 기능이 포함된 보다 복잡한 SharePoint 사이트 정의를 만들 수 있습니다. 자세한 내용은 연습: 추가 콘텐츠를 사용하여 사이트 정의 만들기를 참조하십시오.

이 연습에서는 다음 작업을 수행합니다.

Visual Studio 프로젝트 템플릿을 사용하여 사이트 정의 만들기
SharePoint에서 사이트 정의를 사용하여 SharePoint 사이트 만들기
솔루션에 비주얼 웹 파트 추가
새로운 비주얼 웹 파트를 추가하여 사이트의 default.aspx 페이지 사용자 지정

참고

다음 지침처럼 컴퓨터에서 Visual Studio 사용자 인터페이스 요소 일부에 대한 이름이나 위치를 다르게 표시할 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio 설정을 참조하십시오.

사전 요구 사항

이 연습을 완료하려면 다음 구성 요소가 필요합니다.

지원되는 Microsoft Windows 및 SharePoint 버전. 자세한 내용은 SharePoint 솔루션 개발 요구 사항을 참조하십시오.
Visual Studio 2010.

사이트 정의 솔루션 만들기

먼저 Visual Studio에서 사이트 정의를 만듭니다.

사이트 정의 프로젝트를 만들려면

파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭하여 새 프로젝트 대화 상자를 표시합니다.
Visual C# 또는 Visual Basic 아래의 SharePoint 노드, SharePoint를 차례로 확장한 다음 2010을 클릭합니다.
템플릿 창에서 사이트 정의를 선택합니다.
이름 상자에 TestSiteDef를 입력한 다음 확인을 클릭합니다.

SharePoint 사용자 지정 마법사가 나타납니다.
디버깅에 사용할 사이트 및 보안 수준 지정 페이지에서 사이트 정의를 디버깅할 SharePoint 서버 사이트의 URL을 입력하거나 기본 위치(http://system name/)를 사용합니다.
이 SharePoint 솔루션의 신뢰 수준을 선택하십시오. 섹션에서 기본값인 팜 솔루션으로 배포를 사용합니다.

모든 사이트 정의 프로젝트를 팜 솔루션으로 배포해야 합니다. 샌드박스가 적용된 솔루션과 팜 솔루션 비교에 대한 자세한 내용은 샌드박스가 적용된 솔루션 고려 사항을 참조하십시오.
마침을 클릭합니다. 솔루션 탐색기에 프로젝트가 나타납니다.

비주얼 웹 파트 만들기

다음으로, 사이트 정의의 기본 페이지에 표시할 비주얼 웹 파트를 만듭니다.

비주얼 웹 파트를 만들려면

프로젝트 메뉴에서 새 항목 추가를 클릭하여 새 항목 추가 대화 상자를 표시합니다.
솔루션 탐색기에서 모든 파일 표시 단추를 클릭하여 모든 파일을 표시합니다.
설치된 템플릿 트리 뷰에서 Visual Basic 또는 Visual C# 노드, SharePoint, 2010을 차례로 선택한 다음 프로젝트 항목 템플릿 목록에서 Visual Web Part을 클릭합니다. 기본 이름인 VisualWebPart1을 사용합니다.

VisualWebPart1UserControl.ascx 파일이 열립니다.

VisualWebPart1UserControl.ascx의 맨 아래에 다음 태그를 추가하여 텍스트 상자, 단추, 레이블의 세 컨트롤을 폼에 추가합니다.

<table>
  <tr>
    <td>
      <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
    </td>
    <td>
      <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
    </td>
    <td>
      <asp:Label runat="server" ID="lblName"></asp:Label>
    </td>
  </tr>
</table>

VisualWebPart1UserControl.ascx 아래에 있는 VisualWebPart1UserControl.ascx.cs(Visual C#의 경우) 또는 VisualWebPart1UserControl.ascx.vb(Visual Basic의 경우) 파일을 열고 다음 코드를 추가합니다.
```
Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
    lblName.Text = tbName.Text
End Sub
```
```
protected void btnSubmit_Click(object sender, EventArgs e)
{            
    lblName.Text = tbName.Text;
}
```
이 코드는 웹 파트의 단추 클릭에 대한 기능을 추가합니다.

기본 ASPX 페이지에 비주얼 웹 파트 추가

다음으로, 사이트 정의의 기본 ASPX 페이지에 비주얼 웹 파트를 추가합니다.

기본 ASPX 페이지에 비주얼 웹 파트를 추가하려면

default.aspx 페이지를 열고 페이지에 WebPartPages 태그 아래에 다음 코드를 추가합니다.
```
<%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.SiteDefinition.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
```
이 줄에서는 MyWebPartControls라는 이름을 웹 파트 및 해당 코드에 연결합니다. Namespace 매개 변수는 VisualWebPart1Usercontrol.ascx 코드 파일에 사용되는 네임스페이스와 같습니다.
</asp:Content> 요소 뒤에서 전체 ContentPlaceHolderId="PlaceHolderMain" 섹션과 그 내용을 다음 코드로 바꿉니다.
```
<asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
    <MyWebPartControls:VisualWebPart1 runat="server" />    
</asp:Content>
```
이 코드는 앞에서 만든 비주얼 웹 파트에 대한 참조를 만듭니다.

사이트 정의 솔루션 실행 및 배포

다음으로, 프로젝트를 실행하고 SharePoint에 배포합니다.

사이트 정의를 실행하고 배포하려면

F5 키를 누릅니다. Visual Studio에서 코드를 컴파일하고, 기능을 추가하고, 모든 파일을 WSP 파일로 패키징한 다음 WSP 파일을 SharePoint Server에 배포합니다. 그러면 SharePoint에서 파일을 설치하고 기능을 활성화합니다.

사이트 정의를 기반으로 하여 사이트 만들기

다음으로, 새 사이트 정의를 사용하여 사이트를 만듭니다.

사이트 정의를 사용하여 사이트를 만들려면

SharePoint 사이트에 새 SharePoint 사이트 페이지가 나타납니다.
제목 및 설명 섹션에서 사이트의 제목과 설명으로 My New Site를 입력합니다.
웹 사이트 주소 섹션의 URL 이름 상자에 mynewsite를 입력합니다.
템플릿 섹션에서 SharePoint 사용자 지정 탭을 클릭하고 템플릿 선택 목록에서 TestSiteDef를 선택합니다.
다른 설정은 기본값을 그대로 두고 만들기를 클릭합니다.

새 사이트가 나타납니다.

새 사이트 테스트

다음으로, 새 사이트를 테스트하여 제대로 작동하는지 확인합니다.

새 사이트를 테스트하려면

기본 ASPX 페이지의 텍스트 상자에 일부 텍스트를 입력한 다음 텍스트 상자 옆에 있는 작은 사각형 단추를 클릭합니다.

단추 오른쪽에 있는 레이블에 해당 텍스트가 표시됩니다.

참고 항목

작업

방법: 이벤트 수신자 만들기

기타 리소스

연습: 추가 콘텐츠를 사용하여 사이트 정의 만들기

SharePoint 솔루션 개발