CheckBoxList.LoadPostData(String, NameValueCollection) Method

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Processes the posted data for the CheckBoxList control.

protected:
 virtual bool LoadPostData(System::String ^ postDataKey, System::Collections::Specialized::NameValueCollection ^ postCollection);

protected virtual bool LoadPostData (string postDataKey, System.Collections.Specialized.NameValueCollection postCollection);

abstract member LoadPostData : string * System.Collections.Specialized.NameValueCollection -> bool
override this.LoadPostData : string * System.Collections.Specialized.NameValueCollection -> bool

Protected Overridable Function LoadPostData (postDataKey As String, postCollection As NameValueCollection) As Boolean

Parameters

postDataKey: String

The key identifier for the control, used to index the NameValueCollection specified in the postCollection parameter.

postCollection: NameValueCollection

A NameValueCollection that contains value information indexed by control identifiers.

Returns

Boolean

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

Remarks

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.

Applies to

Jaa