Definizione di una proprietà
Per ulteriori informazioni sulle proprietà, vedere Cenni preliminari sulle proprietà.
Nella porzione di codice riportata di seguito viene definita una proprietà denominata Message sul controllo PropertySample.
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
Quando si definisce una proprietà, è importante specificare i metadati per la proprietà mediante uno o più attributi, come illustrato nella porzione di codice riportata in precedenza. L'elemento Description("The message to display") è un attributo. Affinché una finestra di progettazione visiva visualizzi correttamente il controllo, è necessario fornire a tale finestra i metadati mediante attributi di proprietà, eventi e classi. Per ulteriori informazioni sugli attributi, vedere Attributi delle fasi di progettazione per i componenti.
**Nota **Il termine attributo viene utilizzato in questa sezione per indicare gli attributi dei metadati destinati a Common Language Runtime o strumenti quali gli host delle fasi di progettazione. Questi non devono essere confusi con gli attributi XML o HTML utilizzati nella sintassi della pagina ASP.NET.
Una proprietà può essere un tipo primitivo, un tipo classe o un insieme di tipi primitivi o di tipi classe. I diversi tipi di proprietà vengono descritti in Tipi di proprietà.
Nota La proprietà definita nell'esempio non viene mantenuta durante i percorsi andata/ritorno al client. Per definire proprietà che vengono mantenute, è necessario utilizzare la proprietà ViewState per contenere i dati delle proprietà, come illustrato in Mantenimento dello stato in un controllo.