_XDocument4.IsDOMReadOnly Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
Retourne Boolean.
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.