Export (0) Print
Expand All

FormComponent.ControlMode property

Gets or sets the rendering mode for the form (display, edit, or new).

Namespace:  Microsoft.SharePoint.WebControls
Assembly:  Microsoft.SharePoint (in Microsoft.SharePoint.dll)

public SPControlMode ControlMode { get; set; }

ExceptionCondition
[SPException]

Thrown when trying to get the ControlMode property when there is no valid ControlMode in the parent chain control, no ControlMode property on the page, no ControlMode in the parent chain, no ControlMode property on the page, and when the context is not design time.

[ArgumentException]

Thrown when trying to set the ControlMode to SPControlMode.Invalid.

The control can define its ControlMode property in three ways, listed in order of precedence:

  • On the control.

  • On the parent chain control, which is also a FormComponent object.

  • Based on the ControlMode property set on the page.

If a control does not specify ControlMode on the control itself, it traverses the parent chain to find a control that has set ControlMode. If no parent control is a FormComponent object that has ControlMode set, the ControlMode property of the page is used.

If, after these conditions are checked and the ControlMode is still unknown, and the context is design time, then a default of display mode is used.

NoteNote

Unexpected behavior may occur when you set the ControlMode and ItemContext in OnInit (the ControlMode may be mistakenly set to the new mode). Walking up the tree to find the ControlMode fails because the control has not been added to the control tree yet and its parent control is null.

For all FormComponent controls, create the ItemContext as early as possible so that child controls can get the SPContext object before the controls are added into control tree of the page (before Init).

To find the control mode from parent control while parent control is null, retrieve the control mode from itemContext.FormContext.FormMode.

Community Additions

Show:
© 2014 Microsoft