XMLNode.Validate, méthode

Article
01/06/2014

Valide un contrôle XMLNode par rapport aux schémas XML attachés.

Espace de noms : Microsoft.Office.Tools.Word
Assembly : Microsoft.Office.Tools.Word (dans Microsoft.Office.Tools.Word.dll)

Syntaxe

'Déclaration
Sub Validate

void Validate()

Notes

Utilisez la méthode Validate avec les propriétés ValidationStatus et ValidationErrorText pour déterminer si un élément XML est valide d'après le schéma appliqué et quel texte d'erreur afficher à l'utilisateur. Utilisez la méthode SetValidationError pour substituer les violations de schéma par des erreurs de validation personnalisées.

Lorsque vous exécutez la méthode Validate, Microsoft Office Word remplit la collection XMLSchemaViolations avec les nœuds XML qui ont des erreurs de validation.

Exemples

L'exemple de code suivant définit la valeur texte d'un XMLNode et valide le nœud à l'aide de la méthode Validate. L'exemple utilise ensuite la propriété ValidationStatus pour déterminer si la validation du nœud a réussi. Si le nœud n'a pas été validé, l'exemple utilise la propriété ValidationErrorText pour afficher le message d'erreur de validation. Cet exemple suppose que le document actif contient un XMLNode nommé CustomerAddress1Node. Si CustomerAddress1Node mappe vers un élément de schéma avec un type de données Integer, la validation échoue.

Private Sub ValidateNode()
    Me.CustomerAddress1Node.NodeText = "Nineteen Hundred"
    Me.CustomerAddress1Node.Validate()

    If Me.CustomerAddress1Node.ValidationStatus = _
        Word.WdXMLValidationStatus.wdXMLValidationStatusOK Then
        MsgBox("'" & Me.CustomerAddress1Node.BaseName & "' validates.")
    Else
        MsgBox("'" & Me.CustomerAddress1Node.BaseName & _
            "': " & Me.CustomerAddress1Node.ValidationErrorText(False))
    End If
End Sub

private void ValidateNode()
{
    this.CustomerAddress1Node.NodeText = "Nineteen Hundred";
    this.CustomerAddress1Node.Validate();

    if (this.CustomerAddress1Node.ValidationStatus ==
        Word.WdXMLValidationStatus.wdXMLValidationStatusOK)
    {
        MessageBox.Show("'" + this.CustomerAddress1Node.BaseName +
            "' validates.");
    }
    else
    {
        MessageBox.Show("'" + this.CustomerAddress1Node.BaseName +
            "': " + this.CustomerAddress1Node.ValidationErrorText[false]);
    }
}

Sécurité .NET Framework

Confiance totale accordée à l'appelant immédiat. Ce membre ne peut pas être utilisé par du code d'un niveau de confiance partiel. Pour plus d'informations, consultez Utilisation de bibliothèques à partir de code d'un niveau de confiance partiel.

Voir aussi

Référence

XMLNode Interface

Microsoft.Office.Tools.Word, espace de noms

Partager via