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.
[AttributeUsage(AttributeTargets.Property, Inherited = true, AllowMultiple = false)] public sealed class ImmediatePostDataAttribute : ModelExportedValueAttribute
<AttributeUsage(AttributeTargets.Property, Inherited:=True, AllowMultiple:=False)> Public NotInheritable Class ImmediatePostDataAttribute Inherits ModelExportedValueAttribute
The code snippet below demonstrates how to apply the ImmediatePostData attribute to a business class property in code.
In ASP.NET applications, changing the property value will cause an immediate refresh at the loss of input focus. In Windows Forms and Mobile 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.
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.
- This functionality has certain limitations in an editable List View in ASP.NET applications. Ensure that the application behavior meets your requirements before publishing your application. 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 Mobile applications, non-persistent calculated reference properties are not updated.