逐步解說：將 Visual Studio 2005 網站專案轉換成 Visual Studio 2008 Web 應用程式專案

  • 發行項

更新：2007 年 11 月

本逐步解說說明如何將 Visual Studio 2005 網站專案轉換為 Visual Studio 2008 Web 應用程式專案。Visual Studio 2008 Web 應用程式專案模型就像 Visual Studio 2005 Web 應用程式專案模型一樣，是在 .NET Framework 2.0 SP1 才引入的一項功能。如需 Web 應用程式專案的詳細資訊，請參閱 Web 應用程式專案概觀。 

注意事項：

如果網站是以 Microsoft ASP.NET AJAX 為基礎，則轉換處理序在此逐步解說外還需要其他的步驟。如需詳細資訊，請參閱HOW TO：將 ASP.NET AJAX 1.0 Web 專案升級至 NET Framework 3.5。

本逐步解說將示範下列工作：

  • 在 Visual Studio 2008 中開啟 Visual Studio 2005 網站。

  • 將專案的目標 .NET Framework 版本升級。

  • 建立新的 Visual Studio 2008 Web 應用程式專案。

  • 將 Visual Studio 2005 網站檔案複製到新的 Visual Studio 2008 Web 應用程式專案。

  • 轉換 ASP.NET 程式碼檔案。

  • 測試轉換的專案。

必要條件

若要完成這個逐步解說，您將需要：

  • Visual Studio 2008.

  • 在 Visual Studio 2005 中建立的網站能正確編譯及執行。

轉換網站

一開始，請先在 Visual Studio 2008 中開啟網站以啟動轉換作業。

若要轉換網站

  1. 在 Visual Studio 2008 中的 [檔案] 功能表上，按一下 [開啟]，然後按一下 [網站]。

    [開啟網站] 對話方塊隨即顯示。

  2. 瀏覽至包含網站檔案的資料夾，然後按一下 [開啟]。

    Visual Studio 2008 會提示您將專案升級為 .NET Framework 的目標版本。

  3. 若要升級為 .NET Framework 3.5，請按一下 [是]。

    注意事項：

    您也可以稍後使用專案的屬性頁，手動變更 .NET Framework 的目標版本。

測試轉換的網站

轉換作業完成後，您就可以測試專案以確定可以執行。這也會幫助您識別專案中必須更新的程式碼。

若要驗證 Visual Studio 2005 網站是否能夠順利編譯與執行

  1. 如果您知道程式碼所需的變更才能搭配新版 .NET Framework 來執行，請進行這些變更。

  2. 按一下 [建置] 功能表中的 [建置網站]。

  3. 在 [偵錯] 功能表上按一下 [開始偵錯]。

    如果未啟用偵錯，就會顯示 [未啟用偵錯] 對話方塊。選取選項來加入已啟用偵錯的 Web.config 檔案，然後按一下 [確定]。

    [已停用指令碼偵錯] 對話方塊可能也會一併顯示出來。這表示 Internet Explorer 已停用了指令碼偵錯功能。若要啟用用戶端指令碼的偵錯功能，請遵循對話方塊中的指示進行。

    按一下 [是] 繼續偵錯。

  4. 驗證專案如預期般執行。

    請等到所有的組建與執行階段錯誤都已解決，再繼續進行轉換。

  5. 以滑鼠右鍵按一下 [方案總管] 中的專案名稱，然後按一下 [屬性]。

  6. 按一下 [參考] 索引標籤。

  7. 將專案中必要的參考項目記下來。

    在下一節中您將建立新的專案，這時請確定此專案中所有參考項目也同時出現在新的專案中。

建立 Visual Studio 2008 Web 應用程式專案

現在您可以建立要轉換的目標 Visual Studio 2008 Web 應用程式專案。

若要建立 Visual Studio 2008 Web 應用程式專案

  1. 在 Visual Studio 2008 的 [檔案] 功能表上，按一下 [新增]，然後按一下 [專案]。

    注意事項：

    您可以將 Web 應用程式專案建立成 Visual Studio 專案，而不是網站。

    [新增專案] 對話方塊隨即出現。

  2. 選取 [專案類型] 底下的 [Web]。

  3. 選取您要用在專案上的程式設計語言。

  4. 選取 [範本] 底下的 [ASP.NET Web 應用程式]。

  5. 輸入專案的名稱、位置與方案名稱，然後在 [方案] 清單中選取 [建立新方案]。

    注意事項：

    請在有別於您要轉換之 Visual Studio 2005 網站的其他資料夾中建立專案。這樣一來，轉換處理序就會單純許多。

  6. 在 .NET Framework 版本清單中，選取您在首次轉換時的目標 .NET Framework 版本。

  7. 按一下 [確定]。

    現有的網站會關閉，並建立新的 Web 應用程式專案。

  8. 刪除與新專案一起建立的 Default.aspx 和 Web.config 檔案。

  9. 展開 [方案總管] 中的 [參考]，然後檢查正在轉換之專案的必要參考項目是否列在預設參考項目清單中。

  10. 如果需要額外的參考，請以滑鼠右鍵按一下 [參考] 節點，然後按一下 [加入參考]，並在 [加入參考] 對話方塊中建立必要的參考。

將檔案複製到 Web 應用程式專案

現在您可以將專案檔從舊的專案複製到新的 Web 應用程式專案中了。

若要將檔案從舊的專案複製到 Web 應用程式專案

  1. 在 Windows 檔案總管中，瀏覽至包含 Visual Studio 2005 網站專案檔的資料夾。

  2. 選取您要加入至新專案的檔案與資料夾，然後加以複製。

  3. 在 Visual Studio 的新專案中，以滑鼠右鍵按一下 [方案總管] 中的專案節點，然後按一下 [貼上]，將複製的檔案加入至新專案中。

轉換 ASP.NET 程式碼檔案

在 Visual Studio 2008 中，使用程式碼後置模型的 ASP.NET Web 網頁檔案與使用者控制項檔案，會具有關聯的設計工具檔案。您剛剛轉換的檔案將包含關聯的程式碼後置檔案，但不包含設計工具檔案。因此，下一個步驟就是產生設計工具檔案。

注意事項：

只有在個別程式碼檔案中具有各自程式碼的 ASP.NET Web 網頁與使用者控制項，會需要用到個別的設計工具檔案。如果是具有內嵌 (Inline) 程式碼且沒有關聯之程式碼檔的頁面，就不會產生任何設計工具檔案。

若要轉換 ASP.NET 程式碼檔案

  1. 以滑鼠右鍵按一下 [方案總管] 中的專案節點，然後按一下 [轉換成 Web 應用程式]。

    檔案便會轉換。

  2. 驗證轉換的程式碼檔包含程式碼檔案與設計工具檔案。

測試 Web 應用程式專案

檔案轉換作業完成後，就可以測試專案，確定它是否能以 Web 應用程式專案型式執行。

若要建置並執行轉換的專案

  1. 按一下 [建置] 功能表上的 [建置] 來編譯應用程式。

    專案中任何遺失的參考或其他編譯問題，都會顯示在 [錯誤清單] 視窗中。

  2. 執行專案。

  3. 確認轉換的專案會如預期般執行。

後續步驟

如果您想要將包含 AJAX 功能的 Visual Studio 2005 網站專案轉換成 Visual Studio 2008，整體處理序大致上相同，但還需要額外的步驟。在 Visual Studio 專案轉換完畢後，請執行HOW TO：將 ASP.NET AJAX 1.0 Web 專案升級至 NET Framework 3.5 中所述的步驟。

您可能要將舊版 Visual Studio 中其他類型的專案轉換成 Visual Studio 2008。如需詳細資訊，請參閱概觀：將 Visual Studio 網站和專案轉換為 Visual Studio 2008。

請參閱

工作

HOW TO：將 ASP.NET AJAX 1.0 Web 專案升級至 NET Framework 3.5

概念

概觀：將 Visual Studio 網站和專案轉換為 Visual Studio 2008

.NET Framework 的目標網站

移轉和轉換 ASP.NET 網站