This documentation is archived and is not being maintained.

CheckBoxList.LoadPostData Method

Processes the posted data for the CheckBoxList control.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

protected virtual bool LoadPostData(
	string postDataKey,
	NameValueCollection postCollection


Type: System.String
The key identifier for the control, used to index the NameValueCollection specified in the postCollection parameter.
Type: System.Collections.Specialized.NameValueCollection
A NameValueCollection that contains value information indexed by control identifiers.

Return Value

Type: System.Boolean
true if the state of the CheckBoxList is different from the last posting; otherwise, false.

The LoadPostData method is used primarily by control developers in custom controls that derive from the CheckBoxList class.

The LoadPostData method indicates whether the state of the CheckBoxList control has changed. In other words, it determines whether each list item in the control has the same Selected value as the last posted value. A user selecting or clearing an item in the control changes the Selected property value for the corresponding ListItem object in the Items collection of the CheckBoxList control. If the same list items are selected in the control, or if the CheckBoxList is disabled, LoadPostData returns false.

When the LoadPostData method returns true for a control, the page framework invokes the RaisePostDataChangedEvent method for the control.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.