_XDocument4.IsDOMReadOnly Propriété

Définition

Obtient une valeur qui indique si les données du document XML sous-jacent d’un formulaire Microsoft InfoPath ont été placées en lecture seule.

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

Valeur de propriété

Implémente

Exemples

Dans l’exemple suivant, la propriété IsDOMReadOnly de l’objet XDocument est utilisée pour déterminer si les données du document XML sous-jacent du formulaire ont été placées en lecture seule. Si c'est le cas, une instruction return est utilisée pour quitter le gestionnaire d'événements.

[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...
}

Dans l’exemple suivant, la propriété IsDOMReadOnly de l’objet XDocument est utilisée pour déterminer si les données du document XML sous-jacent du formulaire ont été placées en lecture seule. Si c'est le cas, une instruction return est utilisée pour quitter le gestionnaire d'événements.

[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...
}

Remarques

Si la valeur de la propriété IsDOMReadOnly est true, les données du document XML sous-jacent du formulaire sont en lecture seule et ne peuvent pas être modifiées. Par contre, si la valeur est false, les données du document XML sous-jacent du formulaire peuvent être modifiées.

Pour déterminer si le formulaire a été placé en lecture seule, utilisez la IsReadOnly propriété

Les données du document XML sous-jacent d'un formulaire sont mises en lecture seule dans les cas suivants :

  • Le formulaire est signé numériquement.
  • Le formulaire est en mode de fonctionnalité réduite.
  • Pendant un OnBeforeChange événement
  • Pendant un OnValidate événement
  • Pendant une opération d'annulation ou de rétablissement.

Important : ce membre est accessible uniquement par les formulaires s’exécutant dans le même domaine que le formulaire actuellement ouvert, ou par les formulaires auxquels des autorisations inter-domaines ont été accordées.

S’applique à