Gets or sets the value of the field for the current list item.
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
is the value of the field after the most recent saved change. Unsaved changes, whether made by the user in the UI or by code behind, are not reflected in .
Value is usually identical to immediately after each load of a page or postback, but it can be changed. Typically the change is made through the UI and is not saved until the user takes additional action, such as clicking a Save control. Before the save, Value and have different values.
PostValue is identical to Value in most cases, but it can be useful when users are entering values for Value that are not in the format that the field expects. Use PostValue to hold the correctly formatted version of the value. For example, if the field holds a percentage that users are entering as whole numbers, but the field requires that the value be a fraction of 1, PostValue could be Value divided by 100.
For example, suppose the field is Boolean and rendered as a check box. When the page first loads, is false and the check box is not checked[.] This means that Value is also false, and so is PostValue because there is no special formatting for this Boolean field. The user clicks the check box and Value (and PostValue) become true. The user clicks a Save button and becomes true.
For a second example, suppose the field is a text field in which users enter a percentage as a whole number, but for which values are stored as a fraction of 1. When the page first loads, the , is 0.15 and Value is 15. PostValue is 0.15. The user changes the 15 to 40 and Value becomes 40, and PostValue becomes 0.4. The user clicks a Save button and becomes 0.4.