定義屬性
如果您不熟悉屬性,請參閱屬性概觀。
下列程式片段在控制項 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 屬性來儲存屬性資料,如維護控制項的狀態中所說明的。