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检索控制模式。

另请参阅

引用

FormComponent 类

FormComponent 成员

Microsoft.SharePoint.WebControls 命名空间