Condividi tramite


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.

Vedere anche

Tipi di proprietà | Esempio di proprietà personalizzata