_XDocument4.IsDOMReadOnly 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取一个值,该值指示 Microsoft InfoPath 表单的基础 XML 文档中的数据是否已置于只读状态。
public:
property bool IsDOMReadOnly { bool get(); };
public bool IsDOMReadOnly { get; }
member this.IsDOMReadOnly : bool
Public ReadOnly Property IsDOMReadOnly As Boolean
属性值
返回 Boolean。
实现
示例
在以下示例中,对象的 IsDOMReadOnly 属性 XDocument 用于确定表单的基础 XML 文档中的数据是否已置于只读状态。 如果是,则 return 语句用于退出事件处理程序。
[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnAfterChange)]
public void field1_OnAfterChange(DataDOMEvent e)
{
// Determine whether the XML DOM is read-only.
if (thisXDocument.<span class="label">IsDOMReadOnly</span>)
return;
// Continue normal processing...
}
在以下示例中,对象的 IsDOMReadOnly 属性 XDocument 用于确定表单的基础 XML 文档中的数据是否已置于只读状态。 如果是,则 return 语句用于退出事件处理程序。
[InfoPathEventHandler(MatchPath="/my:myFields/my:field1", EventType=InfoPathEventType.OnAfterChange)]
public void field1_OnAfterChange(DataDOMEvent e)
{
// Determine whether the XML DOM is read-only.
if (thisXDocument.<span class="label">IsDOMReadOnly</span>)
return;
// Continue normal processing...
}
注解
如果 IsDOMReadOnly 属性为 true,则表单的基础 XML 文档中的数据处于只读状态,无法进行更改。 如果该属性为 false,则可以更改表单的基础 XML 文档中的数据。
若要确定窗体是否已处于只读状态,请使用 IsReadOnly 属性
在以下情况下,表单的 XML 文档中的数据将处于只读状态:
- 该表单已数字签名
- 该表单正处于缩减功能模式 (RFM)
- OnBeforeChange在事件期间
- OnValidate在事件期间
- 在撤消或恢复操作过程中