This documentation is archived and is not being maintained.

CheckBoxList.RaisePostDataChangedEvent Method

Notifies the ASP.NET application that the state of the CheckBoxList control has changed.

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

protected virtual void RaisePostDataChangedEvent()

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

The page framework calls the RaisePostDataChangedEvent method on a CheckBoxList control when the LoadPostData method indicates that the state of the list items have changed in the CheckBoxList control. The RaisePostDataChangedEvent method calls the OnSelectedIndexChanged method to raise the SelectedIndexChanged event. Control developers can override the OnSelectedIndexChanged method to perform custom processing when the user selects or clears list items in the control.

The RaisePostDataChangedEvent method can optionally perform validation before raising the SelectedIndexChanged event for the control. To validate a group of controls on the page when a list item within the CheckBoxList is selected, set the AutoPostBack and CausesValidation properties to true, and specify the group of controls to validate in the ValidationGroup property.

.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.