共用方式為


逐步解說:在 Visual Web Developer 中使用網站中的共用程式碼

更新:2007 年 11 月

在建立網站時,Visual Web Developer 可讓您在類別檔案中輕鬆地建立共用程式碼,甚至不需要編譯這些類別檔案,就可以將共用程式碼用於您應用程式中的頁面。

注意事項:

如果您有現有的組件 (.dll 檔案),則可以將它們加入至網站的 Bin 目錄,然後網站會自動參考這些組件。

在此逐步解說中,您將建立一個簡單類別,然後將其用於 ASP.NET Web 網頁。

本逐步解說將說明的工作包括下列項目:

  • 將類別加入至網站。

  • 讓 Visual Web Developer 自動參考元件。

必要條件

若要完成這個逐步解說,您必須進行下列步驟:

  • Visual Web Developer (Visual Studio)。

  • .NET Framework。

本逐步解說假設您已對 Visual Web Developer 中的工作具有一般了解。如需簡介,請參閱逐步解說:在 Visual Web Developer 中建立基本 Web 網頁

建立網站和網頁

如果您已在 Visual Web Developer 中建立了網站 (例如,藉由完成逐步解說:在 Visual Web Developer 中建立基本 Web 網頁逐步解說:在 Visual Web Developer 中建立本機 IIS 網站中的步驟),則可以使用該網站,並繼續進行下一節的步驟。否則,請依照下列這些步驟建立新的網站和 Web 網頁。

若要建立檔案系統網站

  1. 開啟 Visual Web Developer。

  2. 在 [檔案] 功能表上,按一下 [新網站] (在 Visual Web Developer Express 版中的 [檔案] 功能表上,按一下 [新增],然後再按 [網站])。

    [新網站] 對話方塊隨即出現。

  3. 請在 [Visual Studio 安裝的範本] 下方,按一下 [ASP.NET 網站]。

  4. 在 [位置] 方塊中,輸入您想要用來保存網站頁面的資料夾名稱。

    例如:

    • 如果您建立的是檔案系統網站,請輸入 C:\SampleSite。

    • 如果您已經安裝了 IIS 且建立的是 HTTP 網站,請輸入 https://localhost/SampleSite。

  5. 在 [語言] 清單中,按一下您想要操作的程式語言。

  6. 按一下 [確定]。

    Visual Web Developer 會建立網站並開啟名為 Default.aspx 的新頁面。

建立共用類別

您可以籍由將其保存在名為 App_Code 的資料夾中來建立可重複使用的類別。Visual Web Developer 會監視 App_Code 資料夾,並且在加入新的類別檔案時,讓元件可用於您應用程式中的其他程式碼。依照預設,App_Code 資料夾中的類別會在執行階段被編譯為單一組件。

注意事項:

在 App_Code 資料夾中只應放置類別 (和其他受支援的共用類型)。請勿在 App_Code 資料夾中放置頁面、Web 使用者控制項或其他包含非程式碼項目的檔案。

若要建立 App_Code 資料夾

  • 在 [方案總管] 中,以滑鼠右鍵按一下網站名稱,然後按一下 [加入資料夾],再按 [App_Code] 資料夾。

    您現在可以將元件加入至網站。

若要在 App_Code 資料夾中建立共用類別

  1. 在 [方案總管] 中,以滑鼠右鍵按一下 [App_Code],然後按一下 [加入新項目]。

    注意事項:

    請確定在 App_Code 資料夾中而不是在網站的根資料夾中建立新項目。

  2. 請在 [Visual Studio 安裝的範本] 下方,按一下 [類別]。

  3. 在 [名稱] 方塊中, 輸入 SampleClass1。

  4. 在 [語言] 清單中,選取 Web 網頁 (將使用共用類別) 使用的語言。

  5. 按一下 [加入]。

    Visual Web Developer 會在編輯器中開啟新的類別檔案。

  6. 籍由將下列程式碼複製至類別檔案,建立含有名為 testString 之單一屬性的類別:

    Public Class SampleClass1
        private testStringValue As String
        Public Property testString as String
            Get
                return testStringValue
            End Get
            Set (Value as String)
                testStringValue = value
            End Set
        End Property
    End Class
    
    using System;
    public class SampleClass1
    {
        public SampleClass1() 
        {
        }
        private string testStringValue;
        public string testString 
        {
            get
            {
                  return testStringValue;
            }
            set
            {
                   testStringValue = value;
            }
        }
    }
    
  7. 儲存檔案,然後關閉檔案。

    請注意,檔案未儲存為編譯檔案。

    注意事項:

    在 App_Code 資料夾中使用共用類別時,您不需要儲存元件,這樣做可讓 Visual Web Developer 維護對這些元件的參考。如果 Web 網頁和元件使用相同的程式語言,Visual Web Developer 會在記憶體中維護對元件的參考。在這種情形下,請關閉檔案,因為您已使用完畢。

使用共用類別

下一步是在 ASP.NET Web 網頁中使用共用類別。您可以使用建立網站時所建立的 Default.aspx 頁面。

若要使用共用類別

  1. 開啟或切換至 Default.aspx 頁面,然後切換至 [設計] 檢視。

    注意事項:

    如果您沒有 Default.aspx 頁面,則可以使用其他頁面。或者,您可以將新頁面加入至網站。若要進行這項操作,請在 [方案總管] 中以滑鼠右鍵按一下網站名稱,然後按一下 [加入新項目],再按 [Web Form]。在 [語言] 清單中,輸入與元件所使用之語言相同的程式語言,然後按一下 [確定]。

  2. 從 [工具箱] 的 [標準] 資料夾中,將 TextBox 控制項、Label 控制項和 Button 控制項拖曳至頁面。

    注意事項:

    在此逐步解說中,頁面的配置並不重要。

  3. 按兩下 Button 控制項,為它建立 Click 處理常式。

    點選處理常式程式碼可能看起來如下:

    Protected Sub Button1_Click(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles Button1.Click
    
    End Sub
    
    protected void Button1_Click(object sender, EventArgs e)
    {
    
    }
    
  4. 在處理常式中輸入下列內容:

    Dim sc As New
    
    SampleClass1 sc = new
    

    輸入 New 或 new 後,按空格鍵時,Visual Web Developer 會顯示可用類別的清單。在前一章節中建立的 SampleClass1 類別將包含於此清單中。

  5. 透過輸入 SampleClass1 或透過在清單中對其按兩下來完成陳述式,以便陳述式看起來如下:

    Dim sc As New SampleClass1
    
    SampleClass1 sc = new SampleClass1();
    
  6. 按 ENTER,然後輸入下列內容:

    sc.
    

    一旦輸入句點,Visual Web Developer 會再次顯示成員清單,以協助您從範例類別中選取成員。

  7. 使用下列方式完成陳述式和處理常式:

    sc.testString = TextBox1.Text
    Label1.Text = sc.testString
    
    sc.testString = TextBox1.Text;
    Label1.Text = sc.testString;
    
  8. 儲存您的檔案。

測試網頁和類別

您可以執行網站以查看共用類別是否運作。

若要測試網頁和元件

  1. 開啟 Default.aspx 頁面。

  2. 按 CTRL+F5 執行頁面。

  3. 瀏覽器中出現此頁面之後,在文字方塊中輸入一些內容,然後按一下按鈕。

    這樣做會設定簡單類別中的屬性,這個屬性隨後會出現在 Label 控制項中。

如果使用 Microsoft Windows Explorer 檢查網站所在的目錄,則將會看到您的網頁和 App_Code 資料夾。請注意,在 App_Code 資料夾或網站根目錄下的任何地方都沒有 .dll 或其他可執行程式碼。而是,Visual Web Developer 會以動態方式編譯網頁和共用類別。

後續步驟

此逐步解說說明,在不編譯元件的情況下如何將共用類別加入至網站。您可能想以不同方式使用共用類別。例如,您可能要:

請參閱

概念

ASP.NET 網站配置

ASP.NET 網站中的共用程式碼資料夾