共用方式為


逐步解說:將 Visual Studio 2002 或 2003 Web 專案轉換成 Visual Studio 2008 Web 應用程式專案

更新:2007 年 11 月

本逐步解說描述如何將 Visual Studio .NET 2002 或 Visual Studio .NET 2003 Web 專案轉換為 Visual Studio 2008 Web 應用程式專案。Visual Studio 2008 Web 應用程式專案模型就像 Visual Studio 2005 Web 應用程式專案模型一樣,因此,轉換處理序也很類似。如需 Web 應用程式專案的詳細資訊,請參閱 Web 應用程式專案概觀

您也可以將 Visual Studio .NET Web 專案轉換為 Visual Studio 2008 網站專案。但是,支援的方法是轉換為 Web 應用程式專案,並提供您一些方便的工具協助您進行轉換。例如,在您轉換為 Visual Studio 2008 Web 應用程式專案時,可以使用 [Visual Studio 轉換精靈] 來自動化處理序的一部分。如需如何將 Visual Studio .NET Web 專案轉換為 Visual Studio 2008 網站的詳細資訊,請參閱常見的 Web 專案轉換問題和解決方案 (英文)。

將 Visual Studio 2002 或 2003 Web 專案轉換為 Visual Studio 2008 Web 應用程式專案時,牽涉到兩個部分。這些部分如下所示:

  • 轉換專案。您可以使用 [Visual Studio 轉換精靈] 來進行專案與 Web.config 檔案的初始轉換。然後,您可以使用 [轉換成 Web 應用程式] 命令來更新專案的檔案與結構。

  • 升級專案的 .NET Framework 版本。您必須將專案的 .NET Framework 版本升級為 .NET Framework 2.0 SP1 或 .NET Framework 3.5。您需要升級這個 .NET Framework 版本,因為 Visual Studio 2008 無法使用舊版的 .NET Framework。您可以在專案轉換期間,透過轉換精靈執行這個升級。或者,您可以在專案轉換完畢後再升級 .NET Framework 版本。 

    注意事項:

    您可以手動變更專案的 .NET Framework 版本。若要這麼做,請在 Visual Studio 中開啟專案的屬性頁,按一下 [應用程式] 索引標籤,然後從 [目標架構] 清單中選取新版本。

此逐步解說將說明下列工作:

  • 在 Visual Studio 2008 中開啟 Visual Studio .NET 專案,然後建立專案檔的備份。

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

  • 轉換專案檔和 Web.config 檔。

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

  • 測試轉換的專案。

必要條件

若要完成這個逐步解說,您將需要:

  • Visual Studio 2008。

  • 在 Visual Studio .NET 2002 或 2003 版中建立,並能正確編譯且執行的網站專案。

轉換專案並升級 .NET Framework 版本

一開始,請先在 Visual Studio 2008 中開啟專案以啟動轉換作業。如此一來,您將有機會在轉換之前先備份專案。

注意事項:

強烈建議您先備份專案。轉換作業會在原始的專案檔上進行,而且如果沒有成功的話,將無法復原。

若要轉換專案並備份檔案

  1. 在 Visual Studio 2008 中,按一下 [檔案] 功能表中的 [開啟],然後按一下 [專案]。

    [開啟專案] 對話方塊隨即顯示。

  2. 瀏覽至包含 Visual Studio .NET 專案或方案檔的資料夾並選取檔案,然後按一下 [開啟]。

    注意事項:

    使用 [開啟專案] 命令,確定已開啟專案。如果您使用 [開啟網站] 命令,則專案會轉換成網站專案格式。

    轉換精靈會在專案轉換之前開啟並提示您建立備份。

  3. 若要建立備份,按一下 []。

  4. 按一下 [瀏覽],選取要在其中建立備份的資料夾,然後按 [下一步]。

  5. 按一下 [完成]。

    備份作業隨即啟動。

    注意事項:

    轉換精靈可能需要很長一段時間來複製檔案,在這段期間您將看不到任何更新或進度說明。請耐心等候處理序完成動作,再進行下一步。

    一旦轉換完畢,精靈就會提示您升級專案的 .NET Framework 目標版本。

  6. 若要升級為 .NET Framework 3.5,請按一下 []。若要將專案升級為 .NET Framework 2.0 SP1 目標版本,按一下 []。

    針對詢問您是否要升級方案中所有 Web 的核取方塊,建議您保留其選取狀態。

    如果您升級至 .NET Framework 3.5,專案的 Web.config 檔案就會與專案檔一起遭到修改。

    當升級與轉換作業都順利完成時,會顯示一個訊息,表示您已完成專案轉換的第一步。

  7. 按一下 [確定]。

    精靈會顯示轉換的狀態資訊。

  8. 按一下 [關閉]。

測試轉換的專案

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

若要驗證專案能夠順利執行

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

  2. 按一下 [建置] 功能表上的 [建置]。

    專案中任何遺失的參考或其他編譯問題,都會顯示在 [錯誤清單] 視窗中。最有可能的問題是遺失了組件參考或是與動態產生的型別相關的問題。

  3. 在 [方案總管] 中,以滑鼠右鍵按一下要用來啟動應用程式的 Web 網頁,然後按一下 [設定為起始頁]。

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

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

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

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

轉換 ASP.NET 程式碼檔案

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

注意事項:

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

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

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

    檔案隨即轉換。

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

  3. 建置並執行專案以驗證轉換的結果。

請參閱

概念

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

Web 應用程式專案概觀

其他資源

從 Visual Studio .NET 2002 或 2003 轉換