_XDocument2.IsDOMReadOnly-Eigenschaft

Článek
04/27/2010

Ruft einen Wert ab, der angibt, ob die Daten in dem zugrunde liegenden XML-Dokument eines Formulars in den Schreibschutzmodus versetzt wurden.

Diese Eigenschaft ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

'Declaration
<DispIdAttribute(39)> _
ReadOnly Property IsDOMReadOnly As Boolean
'Usage
Dim instance As _XDocument2
Dim value As Boolean

value = instance.IsDOMReadOnly

[DispIdAttribute(39)] 
bool IsDOMReadOnly { get; }

Hinweise

Wenn die IsDOMReadOnly-Eigenschaft true lautet, befinden sich die Daten in dem einem Formular zugrunde liegenden XML-Dokument im Schreibschutzmodus und können nicht geändert werden. Lautet die Eigenschaft false, können die Daten im XML-Dokument geändert werden.

Um zu bestimmen, ob das Formular in den Schreibschutzmodus versetzt wurde, verwenden Sie die IsReadOnly-Eigenschaft.

In den folgenden Situationen werden die Daten in dem einem Formular zugrunde liegenden XML-Dokument in den Schreibschutzmodus versetzt:

Das Formular ist digital signiert.
Das Formular befindet sich im RFM-Modus (Reduced Functionality Mode, Modus mit eingeschränkter Funktionalität).
Während eines OnBeforeChange-Ereignisses
Während eines OnValidate-Ereignisses
Während ein Vorgang rückgängig gemacht oder wiederholt wird.

Wichtig:
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Beispiel

Im folgenden Beispiel wird die IsDOMReadOnly-Eigenschaft des XDocument-Objekts verwendet, um zu bestimmen, ob die Daten im dem Formular zugrunde liegenden XML-Dokument geändert wurden. Ist dies der Fall, wird eine return-Anweisung verwendet, um den Ereignishandler zu beenden.

[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.IsDOMReadOnly)
  return;

 // Continue normal processing...
}

Siehe auch

Referenz

_XDocument2-Schnittstelle
_XDocument2-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Sdílet prostřednictvím