FormComponent.ControlMode 属性
获取或设置表单的呈现模式 (显示、 编辑或新建)。
命名空间: Microsoft.SharePoint.WebControls
程序集: Microsoft.SharePoint(位于 Microsoft.SharePoint.dll 中)
语法
声明
Public Property ControlMode As SPControlMode
Get
Set
用法
Dim instance As FormComponent
Dim value As SPControlMode
value = instance.ControlMode
instance.ControlMode = value
public SPControlMode ControlMode { get; set; }
属性值
类型:Microsoft.SharePoint.WebControls.SPControlMode
异常
异常 | 条件 |
---|---|
[SPException] | 当尝试获取ControlMode属性,在父链控件中,在页上,在父链,没有ControlMode属性在页上,并的上下文不是设计时没有ControlMode没有ControlMode属性没有有效ControlMode时引发。 |
[ArgumentException] | 试图将ControlMode设置为SPControlMode.Invalid时引发。 |
备注
该控件可定义其ControlMode属性中的优先顺序列出的三种方法:
在控件中。
上也是FormComponent对象的父链控件。
基于ControlMode属性页上的设置。
如果控件不在控件本身上指定ControlMode ,它将遍历父链,以查找已设置ControlMode的控件。如果没有父控件是FormComponent对象具有ControlMode设置,则使用页上的ControlMode属性。
如果这些条件进行检查和ControlMode仍未知,且的上下文是设计时间后,则使用默认的显示模式。
备注
OnInit ( ControlMode可能会错误地设置为新模式) 中设置的ControlMode和ItemContext时,可能会出现异常的行为。遍历树以查找ControlMode失败,因为该控件尚未添加到控件树尚未和其父控件为 null。
对于所有FormComponent控件, ItemContext早创建尽可能上,以便子控件可以获取SPContext对象之前将控件添加到 (在之前Init) 页上的控件树。
若要查找从父控件的控制模式下,在父控件为 null 时,请从itemContext.FormContext.FormMode检索控制模式。