ImmediatePostDataAttribute Class

Applied to business class properties. Indicates that the property editor’s control value should be passed to the property of a bound object as soon as possible when the value is changed by user. For instance, it allows you to enforce updating other displayed values that are calculated based on the current property.

Namespace: DevExpress.Persistent.Base

Assembly: DevExpress.ExpressApp.v20.2.dll

NuGet Package: DevExpress.ExpressApp

Declaration

C#

[AttributeUsage(AttributeTargets.Property, Inherited = true, AllowMultiple = false)]
public sealed class ImmediatePostDataAttribute :
    ModelExportedValueAttribute

VB.NET

<AttributeUsage(AttributeTargets.Property, Inherited:=True, AllowMultiple:=False)>
Public NotInheritable Class ImmediatePostDataAttribute
    Inherits ModelExportedValueAttribute

Remarks

The code snippet below demonstrates how to apply the ImmediatePostData attribute to a business class property in code.

C#

using DevExpress.Persistent.Base;
// ...
[ImmediatePostData]
public double Rate {
    get {
        //...
    }
    set {
        //...           
    }
}

VB.NET

Imports DevExpress.Persistent.Base
' ...
<ImmediatePostData>
Public Property Rate() As Double
    Get
        '...
    End Get
    Set(ByVal value As Double)
        '...           
    End Set
End Property

In ASP.NET applications, changing the property value will cause an immediate refresh at the loss of input focus. In Windows Forms applications, the current property’s value will update immediately.

By applying the attribute, you automatically set the Application Model‘s BOModel | <Class> | OwnMembers | <Member> | ImmediatePostData default property value to true.

Note that you can set or change this property’s value using the Model Editor as shown in the Make a Property Calculable topic.

Any changes to the BOModel | <Class> | OwnMembers | <Member> | ImmediatePostData property value affect the default value of the same property in the following nodes:

• Views | <DetailView> | Items | <PropertyEditor>,
• Views | <ListView> | Columns | <Column>.

You can modify the property’s value in the nodes above to, for example, disable ImmediatePostData for certain Views.

These nodes’ ImmediatePostData properties specify the default values for the corresponding PropertyEditor.ImmediatePostData properties.

The diagram below demonstrates different levels where the ImmediatePostData setting can be applied. Higher levels determine default values for lower levels.

Note

• In ASP.NET WebForms applications, the ImmediatePostData attribute raises a callback that posts all editor values to business objects and can re-render all editors on a page. It may cause unexpected behavior in complex scenarios (for example, in editable List Views). You can always invoke the Model Editor for the ASP.NET project and disable the Views | <ListView> | Columns | <Column> | ImmediatePostData property for a specific column.
• In Batch edit mode, ImmediatePostData affects properties of a current row only.

Inheritance

Object

Attribute

DevExpress.Persistent.Base.ModelExportedValueAttribute

ImmediatePostDataAttribute