연습: Visual Studio .NET 2003 웹 프로젝트를 Visual Studio 웹 응용 프로그램 프로젝트로 변환

아티클
10/22/2014

업데이트: 2007년 11월

Visual Studio .NET 2003 웹 프로젝트를 Visual Studio 2008 웹 응용 프로그램 프로젝트로 변환하면 Visual Studio 2008의 기능을 활용할 수 있습니다. 이러한 기능으로는 리팩터링, 클래스 다이어그램, 테스트 개발, 제네릭 등이 있습니다. 웹 응용 프로그램 프로젝트 모델에서는 ASP.NET 2.0 이상의 모든 기능도 사용할 수 있습니다. 이러한 기능으로는 마스터 페이지, 데이터 컨트롤, 멤버 자격과 로그온 컨트롤, 역할 관리, 웹 파트, 개인 설정, 사이트 탐색, 테마 등이 있습니다.

Visual Studio 2008 웹 응용 프로그램 프로젝트 모델은 Visual Studio .NET 2003 응용 프로그램에 사용할 수 있는 프로젝트 모델과 보다 잘 일치합니다. 따라서 Visual Studio .NET 2003 웹 프로젝트를 Visual Studio 2008로 쉽게 변환할 수 있습니다. 새 기능에 대한 자세한 내용은 ASP.NET의 새로운 기능과 웹 개발을 참조하십시오.

참고:
Visual Studio 또는 Visual Web Developer Express Edition을 사용하여 ASP.NET 웹 응용 프로그램 프로젝트를 만들 수 있습니다.

이 연습에서는 기존 Visual Studio .NET 2003 웹 프로젝트를 Visual Studio 2008의 웹 응용 프로그램 프로젝트로 변환하는 방법을 설명합니다. 이 웹 응용 프로그램 프로젝트 모델에 사용되는 개념적 접근 방식은 Visual Studio .NET 2003의 웹 프로젝트와 동일합니다. 여기에는 파일 포함 및 제외를 위한 프로젝트 파일과 단일 어셈블리로의 컴파일이 포함됩니다. 자세한 내용은 Visual Studio .NET에서 웹 프로젝트 변환을 참조하십시오.

참고:
Microsoft Office FrontPage 2003을 사용하는 웹 사이트를 웹 응용 프로그램 프로젝트로 변환하려면 먼저 FrontPage 웹 사이트를 Visual Studio 2008 웹 사이트 프로젝트로 변환합니다. 그런 다음 웹 사이트 프로젝트를 웹 응용 프로그램 프로젝트로 변환합니다. 자세한 내용은 연습: Visual Studio에서 웹 사이트 프로젝트를 웹 응용 프로그램 프로젝트로 변환을 참조하십시오.

Microsoft Office FrontPage 2003을 사용하는 웹 사이트를 웹 응용 프로그램 프로젝트로 변환하려면 먼저 FrontPage 웹 사이트를 Visual Studio 2008 웹 사이트 프로젝트로 변환합니다. 그런 다음 웹 사이트 프로젝트를 웹 응용 프로그램 프로젝트로 변환합니다. 자세한 내용은 연습: Visual Studio에서 웹 사이트 프로젝트를 웹 응용 프로그램 프로젝트로 변환을 참조하십시오.

이 연습에서 수행할 작업은 다음과 같습니다.

Visual Studio .NET 2003 웹 프로젝트 열기 및 확인
Visual Studio .NET 2003 웹 프로젝트 백업
Visual Studio .NET 2003 웹 프로젝트를 Visual Studio 2008로 변환
Visual Studio 2008에서 웹 응용 프로그램 프로젝트 확인
코드 숨김 클래스를 partial 클래스로 변환
XHTML 호환성 문제 검사 및 해결

사전 요구 사항

이 연습을 따라 하려면 다음과 같은 요건을 갖추어야 합니다.

Visual Studio .NET 2003
Visual Studio 2008 또는 Visual Studio 2005 SP1(서비스 팩 1) 또는 Visual Web Developer Express Edition
.NET Framework 버전 2.0

Visual Studio .NET 2003 웹 프로젝트 열기 및 확인

프로젝트를 변환하려면 먼저 해당 프로젝트가 제대로 작동하는지 확인해야 합니다. 이렇게 해야 변환 과정에서 오류가 발생하지 않습니다.

Visual Studio .NET 2003 웹 프로젝트를 열고 확인하려면

Visual Studio .NET 2003을 엽니다.
파일 메뉴에서 파일 열기를 클릭한 다음 확인할 솔루션의 .sln 파일을 입력하거나 찾습니다.

참고:

Visual Studio .NET 2003에는 프로젝트를 구성하는 파일이 솔루션 파일(.sln)에 포함됩니다.
프로젝트 메뉴에서 솔루션 빌드를 클릭합니다.
디버그 메뉴에서 시작을 클릭합니다.
프로젝트가 정상적으로 실행되는지 확인합니다.

참고:
Visual Studio .NET 2003에는 프로젝트를 구성하는 파일이 솔루션 파일(.sln)에 포함됩니다.

Visual Studio .NET 2003 웹 프로젝트 백업

변환 프로세스를 시작하기 전에 Visual Studio .NET 2003 솔루션과 프로젝트 파일을 백업해 두는 것이 좋습니다. 이렇게 하면 변환 과정에서 문제가 발생했을 때 Visual Studio .NET 2003 솔루션으로 되돌릴 수 있습니다.

프로젝트를 백업하려면 Visual Studio .NET 2003에서 프로젝트를 복사합니다.

변환 전에 Visual Studio .NET 2003 웹 프로젝트를 백업하려면

Visual Studio .NET 2003을 엽니다.
파일 메뉴에서 파일 열기를 클릭한 다음 백업할 솔루션의 .sln 파일을 입력하거나 찾습니다.
프로젝트 메뉴에서 프로젝트 복사를 클릭합니다.
프로젝트 복사 상자에서 대상프로젝트 폴더를 선택합니다.
웹 액세스 방법 옵션을 선택합니다. FrontPage나 파일 공유를 사용하여 파일을 복사할 수 있습니다.
프로젝트 폴더의 모든 파일 옵션을 선택한 다음 확인을 클릭합니다.

Visual Studio .NET 2003 웹 프로젝트를 Visual Studio 2008로 변환

Visual Studio 2008의 프로젝트 파일 형식인 Microsoft Build Engine(MSBuild) 형식을 사용하도록 Visual Studio 2008에서 Visual Studio .NET 2003 솔루션 및 프로젝트 파일을 변환합니다.

변환 프로세스를 진행하는 동안 Visual Studio 2008에서 변환에 대한 요약 정보를 제공하며 문제점을 알려 주는 XML 기반 로그 파일이 생성됩니다. 기본적으로 변환 로그 파일은 .sln 파일과 동일한 디렉터리에 저장됩니다. 변환된 프로젝트를 컴파일할 때 문제가 발생하면 이 변환 로그 파일을 다시 참조할 수 있습니다.

웹 프로젝트를 Visual Studio 2008로 변환하려면

Visual Studio .NET 2003에서 솔루션 파일을 닫습니다.
Visual Studio 2008을 엽니다.
파일 메뉴에서 파일 열기를 클릭한 다음 변환할 솔루션의 .sln 파일을 입력하거나 찾습니다.

Visual Studio 2008 변환 마법사가 열립니다.
다음을 클릭하고 지침에 따라 마법사를 완료한 다음 마침을 클릭합니다.

Visual Studio 2008에서 웹 응용 프로그램 프로젝트 확인

솔루션과 프로젝트 파일을 Visual Studio 2008 형식으로 변환한 후 응용 프로그램이 오류 없이 빌드되고 정상적으로 실행되는지 확인해야 합니다.

Visual Studio 2008에서 웹 응용 프로그램 프로젝트를 확인하려면

Visual Studio 2008의 파일 메뉴에서 파일 열기를 클릭한 다음 확인할 솔루션의 .sln 파일을 입력하거나 찾습니다.
프로젝트 메뉴에서 솔루션 빌드를 클릭합니다.
디버그 메뉴에서 시작을 클릭합니다.
웹 응용 프로그램 프로젝트가 예상대로 실행되는지 확인합니다.

일반적인 오류 및 경고

변환 프로세스를 진행하는 동안 가장 일반적으로 발생하는 오류 또는 경고는 다음과 같습니다.

.NET Framework 버전 2.0에 제공한 이름과 충돌
사용되지 않는 멤버에 대한 경고
웹 응용 프로그램을 실행할 때 발생하는 문제

이름 충돌 문제를 해결하려면 네임스페이스로 기존 이름을 정규화하여 이름을 명확히 합니다. 또는 충돌하는 형식과 멤버의 이름이 충돌하지 않도록 해당 이름을 변경할 수도 있습니다. 이름 충돌에 대한 자세한 내용은 ASP.NET 2.0 마이그레이션 개요 및 Namespace Naming Guidelines를 참조하십시오.

사용되지 않는 멤버에 대한 경고 메시지에는 일반적으로 제안되는 대체 멤버가 함께 표시됩니다. 이 경우 사용되지 않는 멤버를 계속 사용할 수도 있습니다. 그러나 .NET Framework의 향후 주요 릴리스에서는 이러한 멤버가 제거될 예정입니다. 따라서 이러한 멤버를 제거하고 제안된 멤버를 대신 사용하는 것이 좋습니다.

웹 응용 프로그램을 실행할 때 디렉터리 나열이 거부되었음을 나타내는 오류가 발생하면 웹 응용 프로그램의 가상 디렉터리에서 해당 콘텐츠를 나열할 수 없는 것일 수 있습니다. 이 문제를 해결하려면 솔루션 탐색기에서 응용 프로그램의 시작 페이지를 마우스 오른쪽 단추로 클릭한 다음 시작 페이지로 설정을 클릭합니다. 이렇게 하면 응용 프로그램을 실행할 때 올바른 페이지가 호출됩니다.

코드 숨김 클래스를 partial 클래스로 변환

Visual Studio 2008의 경우 웹 응용 프로그램 프로젝트에서는 Visual Studio를 통해 생성된 코드에 대해 partial 클래스를 사용합니다. 이러한 클래스는 코드 숨김 파일과 다른 별도의 파일에 저장됩니다. 기본적으로 Visual Studio 2008 변환 마법사는 사용자 정의 컨트롤(.ascx 파일) 또는 웹 페이지(.aspx 파일)에 대해 *.designer.cs 파일이나 *.designer.vb 파일을 만들지 않습니다. 대신 코드는 Visual Studio .NET 2003에서와 똑같이 보이고 작동합니다.

참고:
Visual Studio 2008 변환 마법사는 변환을 진행하는 동안 코드 파일을 최소한만 변경하므로 Visual Studio 2008에서 웹 응용 프로그램 프로젝트로 원활하게 변환할 수 있습니다.

코드를 Visual Studio .NET 2003 형식으로 유지할 수 있습니다. 이렇게 형식을 유지하려면 Visual Studio .NET 2003의 경우와 같이 코드 숨김 파일의 컨트롤 필드 선언을 수동으로 업데이트해야 합니다. 그러나 생성된 코드의 필드 선언을 유지하는 기능을 사용하려면 partial 클래스 모델을 사용하도록 페이지와 컨트롤을 업데이트해야 합니다. partial 클래스를 사용하면 코드 숨김 파일의 생성된 코드와 사용자 지정 코드를 더 쉽게 구성할 수 있습니다. 자세한 내용은 Partial(Visual Basic) 및 부분(형식)(C# 참조)을 참조하십시오.

partial 클래스 모델을 사용하도록 코드를 변환하려면

코드가 오류 없이 컴파일되는지 확인합니다.

솔루션 탐색기에서 프로젝트 이름을 마우스 오른쪽 단추로 클릭하고 웹 응용 프로그램으로 변환을 클릭합니다.

이 명령은 프로젝트의 페이지와 사용자 컨트롤 각각에 대해 반복적으로 실행됩니다. 이 명령은 모든 컨트롤 선언을 .designer.cs 또는 designer.vb 파일로 옮깁니다. 또한 이 명령은 이벤트 처리기 선언을 .aspx 및 .ascx 파일의 서버 컨트롤 태그에 추가합니다.

참고:
웹 응용 프로그램으로 변환 명령을 개별 페이지에서 사용할 수 있습니다. 전체 응용 프로그램에 변경 내용을 적용하기 전에 각 페이지의 변경 내용을 확인할 수 있도록 먼저 몇몇 페이지에 대해 이 작업을 수행할 수 있습니다.

웹 응용 프로그램으로 변환 명령의 결과를 실행 취소할 수는 없습니다. 변경 내용을 복원하는 가장 좋은 방법은 Visual Studio .NET 2003 프로젝트의 백업에서 복원한 후 앞서 설명한 대로 Visual Studio 2008 변환을 다시 실행하는 것입니다.

프로세스가 완료되면 작업 목록 창에서 변환 오류가 보고되었는지 확인합니다.

작업 목록에 오류가 표시된 경우 솔루션 탐색기에서 관련 페이지를 마우스 오른쪽 단추로 클릭하고 코드 보기와 코드 생성 파일 보기를 선택하여 코드를 검사하고 문제를 수정합니다.

참고:
작업 목록 창에 나타나는 오류와 경고는 Visual Studio 세션 간에 유지됩니다. 창에 나열된 오류를 수정한 후에는 작업 목록에서 항목을 지울 수 있습니다.

프로젝트를 다시 컴파일하여 프로젝트가 오류 없이 컴파일되는지 확인합니다.

이제부터는 웹 프로젝트에 새 페이지를 추가할 때 페이지에 기본적으로 partial 클래스 템플릿이 사용됩니다. 자세한 내용은 ASP.NET 2.0 마이그레이션 개요를 참조하십시오.

XHTML 호환성 문제 검사 및 해결

기본적으로 Visual Studio 2008에서는 XHTML과 호환되는 태그를 생성하고 그 유효성을 검사합니다. 이를 통해 표준과 호환되는 웹 응용 프로그램을 빌드하고 브라우저별 렌더링 문제를 최소화할 수 있습니다. 기본적으로 Visual Studio .NET 2003에서는 XHTML과 호환되는 태그를 생성하지 않습니다. 따라서 웹 응용 프로그램을 Visual Studio 2008로 변환한 후 Visual Studio .NET 2003에서 만든 페이지에 유효성 검사 및 렌더링 문제가 발생할 수 있습니다.

참고:
유효성 검사 오류는 정보용으로만 제공되며 경고로 플래그가 지정됩니다. 유효성 검사 오류가 있어도 페이지가 실행됩니다.

Visual Studio .NET 2003에서와 같이 HTML 유효성 검사 오류를 보려면 HTML 유효성 검사 설정을 XHTML Transitional에서 Internet Explorer 6.0으로 전환합니다. Visual Studio .NET 2003에서 HTML 유효성 검사의 기본 설정은 Internet Explorer 6.0입니다. 자세한 내용은 방법: Visual Web Developer에서 HTML 편집에 대한 유효성 검사 스키마 선택을 참조하십시오.

프로젝트의 Web.config 파일에 다음 섹션을 추가하여 ASP.NET에서 서버 컨트롤의 레거시 태그, 즉 XHTML과 호환되지 않는 태그를 렌더링하게 할 수도 있습니다.

<system.Web>
  <xhtmlConformance mode="Legacy" />
</system.Web>

이렇게 하면 ASP.NET 1.1을 사용하여 페이지를 표시할 때와 ASP.NET 2.0을 사용하여 페이지를 표시할 때 나타나는 소소한 렌더링 차이를 방지할 수 있습니다. xhtmlConformance 모드 변경은 변환 문제를 해결하려는 경우에만 사용해야 합니다. 웹 응용 프로그램 프로젝트가 제대로 실행되면 레거시 구성 설정을 제거합니다. 자세한 내용은 ASP.NET 및 XHTML 및 ASP.NET 2.0 마이그레이션 개요를 참조하십시오.

참고 항목

다음을 통해 공유