Export (0) Print
Expand All
Expand Minimize

PersistenceMode Enumeration

Specifies how an ASP.NET server control property or event is persisted declaratively in an .aspx or .ascx file.

[Visual Basic]
<Serializable>
Public Enum PersistenceMode
[C#]
[Serializable]
public enum PersistenceMode
[C++]
[Serializable]
__value public enum PersistenceMode
[JScript]
public
   Serializable
enum PersistenceMode

Members

Member name Description
Attribute Specifies that the property or event persists as an attribute.
EncodedInnerDefaultProperty Specifies that the property persists as the only inner text of the ASP.NET server control. The property value is HTML encoded. Only a string can be given this designation.
InnerDefaultProperty Specifies that the property persists in the ASP.NET server control as a inner text. Also indicates that this property is defined as the element's default property. Only one property can be designated the default property.
InnerProperty Specifies that the property persists in the ASP.NET server control as a nested tag. This is commonly used for complex objects; those that have persistable properties of their own.

Example

[Visual Basic, C#, C++] The following example demonstrates an ITemplate property that will be persisted as an inner property as defined by applying the PersistenceModeAttribute to the property's metadata.

[Visual Basic] 

      <PersistenceMode(PersistenceMode.InnerProperty), TemplateContainer(GetType(TemplateItem))> Public Property MessageTemplate() As ITemplate
         Get
            Return _messageTemplate
         End Get
         Set(ByVal Value As ITemplate)
            _messageTemplate = Value
         End Set
      End Property


[C#] 
[PersistenceMode(PersistenceMode.InnerProperty),
TemplateContainer(typeof(TemplateItem))]
public ITemplate MessageTemplate {
   get {
      return _messageTemplate;
   }
   set {
      _messageTemplate = value;
   }
}

[C++] 
public:
   [PersistenceMode(PersistenceMode::InnerProperty),
      TemplateContainer(__typeof(TemplateItem))]
   __property ITemplate* get_MessageTemplate() {
      return _messageTemplate;
   }
   __property void set_MessageTemplate( ITemplate* value ) {
      _messageTemplate = value;
   }

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Namespace: System.Web.UI

Platforms: Windows 2000, Windows XP Professional, Windows Server 2003 family

Assembly: System.Web (in System.Web.dll)

See Also

System.Web.UI Namespace | PersistenceModeAttribute

Show:
© 2014 Microsoft