CheckBoxList.LoadPostData(String, NameValueCollection) Method

Definition

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

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

See also