_XDocument3.IsDOMReadOnly Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает значение, указывающее, были ли данные в базовом XML-документе формы Microsoft InfoPath помещены в состояние только для чтения.
public:
property bool IsDOMReadOnly { bool get(); };
public bool IsDOMReadOnly { get; }
member this.IsDOMReadOnly : bool
Public ReadOnly Property IsDOMReadOnly As Boolean
Значение свойства
Реализации
Примеры
В следующем примере свойство XDocumentIsDOMReadOnly объекта используется для определения того, были ли данные в базовом 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...
}
В следующем примере свойство XDocumentIsDOMReadOnly объекта используется для определения того, были ли данные в базовом 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 Во время события
- В ходе операций отмены или возврата.
Важно! Доступ к этому члену можно получить только с помощью форм, работающих в том же домене, что и открытая форма, или с помощью форм, которым предоставлены междоменные разрешения.