Freigeben über


_XDocument4.IsDOMReadOnly Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob die Daten im zugrunde liegenden XML-Dokument eines Microsoft InfoPath-Formulars in einen schreibgeschützten Zustand versetzt wurden.

public:
 property bool IsDOMReadOnly { bool get(); };
public bool IsDOMReadOnly { get; }
member this.IsDOMReadOnly : bool
Public ReadOnly Property IsDOMReadOnly As Boolean

Eigenschaftswert

Implementiert

Beispiele

Im folgenden Beispiel wird die IsDOMReadOnly-Eigenschaft des XDocument -Objekts verwendet, um zu bestimmen, ob Daten im dem Formular zugrunde liegenden XML-Dokument in einen schreibgeschützten Zustand versetzt 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.<span class="label">IsDOMReadOnly</span>)
  return;

 // Continue normal processing...
}

Im folgenden Beispiel wird die IsDOMReadOnly-Eigenschaft des XDocument -Objekts verwendet, um zu bestimmen, ob Daten im dem Formular zugrunde liegenden XML-Dokument in einen schreibgeschützten Zustand versetzt 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.<span class="label">IsDOMReadOnly</span>)
  return;

 // Continue normal processing...
}

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.

Verwenden Sie die IsReadOnly -Eigenschaft, um zu bestimmen, ob das Formular in einen schreibgeschützten Zustand versetzt wurde.

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 Ereignisses OnBeforeChange
  • Während eines Ereignisses OnValidate
  • Während ein Vorgang rückgängig gemacht oder wiederholt wird.

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

Gilt für: