共用方式為


定義屬性

如果您不熟悉屬性,請參閱屬性概觀

下列程式片段在控制項 PropertySample 定義名為 Message 的屬性。

public class PropertySample : Control {
   private string  message;
   [Category("Text")]
   [Description("The message to display")]
   public string Message {
       get {
          return message;
       }
       set {
          message = value;
       }
   }
   ...
}
[Visual Basic]
Option Explicit
Option Strict

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.ComponentModel

Public Class PropertySample
   Inherits Control
   Private _message As String
   
   <Category("Text"), Description("The message to display")> _
   Public Property Message() As String
      Get
         Return _message
      End Get
      Set
         _message = value
      End Set
   End Property
   ...
End Class

定義屬性時,使用一個或幾個屬性來指定屬性的中繼資料,是很重要的,如前面程式碼片段所示範的。項目 Description("The message to display") 是屬性 (Attribute)。若要視覺設計工具正確顯示您的控制項,您必須透過屬性、事件和類別屬性以提供中繼資料給設計工具。如果您不熟悉屬性,請參閱元件的設計階段屬性

注意 詞彙「屬性」在本章節用來代表以 Common Language Runtime 或工具 (例如設計階段主應用程式) 為目標的中繼資料屬性。不要將這些和用於 ASP.NET 網頁語法的 XML 或 HTML 屬性一起混淆。

屬性可以是基本型別、類別型別,或基本型別或類別型別的集合。各種屬性型別都說明於屬性型別

注意 範例中定義的屬性不會在往返用戶端期間保存。若要定義保存的屬性,您必須使用 ViewState 屬性來儲存屬性資料,如維護控制項的狀態中所說明的。

請參閱

屬性型別 | 自訂屬性範例