_XDocument4.IsDOMReadOnly Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.