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.