XMLNode.Validate-Methode

Artikel
05/07/2013

Validiert ein einzelnes XMLNode-Steuerelement anhand des oder der angefügten XML-Schemas.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (in Microsoft.Office.Tools.Word.dll)

Syntax

'Declaration
Sub Validate

void Validate()

Hinweise

Verwenden Sie die Validate-Methode mit der ValidationStatus-Eigenschaft und der ValidationErrorText-Eigenschaft, um zu bestimmen, ob ein XML-Element gemäß dem angewendeten Schema gültig ist und welcher Fehlertext angezeigt wird.Überschreiben Sie mit der SetValidationError-Methode die Schemaverletzungen durch benutzerdefinierte Validierungsfehler.

Wenn Sie die Validate-Methode ausführen, füllt Microsoft Office Word die XMLSchemaViolations-Auflistung mit den XML-Knoten auf, die Validierungsfehler aufweisen.

Beispiele

Im folgenden Codebeispiel wird der Textwert eines XMLNode festgelegt, und der Knoten wird mit der Validate-Methode validiert.Dann wird anhand der ValidationStatus-Eigenschaft bestimmt, ob die Validierung des Knotens erfolgreich war.Wenn die Validierung des Knotens nicht erfolgreich war, wird die mit der ValidationErrorText-Eigenschaft festgelegte Validierungsfehlermeldung angezeigt.In diesem Beispiel wird davon ausgegangen, dass das aktuelle Dokument einen XMLNode mit dem Namen CustomerAddress1Node enthält.Wenn CustomerAddress1Node einem Schemaelement mit einem Ganzzahldatentyp zugeordnet ist, schlägt die Validierung fehl.

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]);
    }
}

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

XMLNode Schnittstelle

Microsoft.Office.Tools.Word-Namespace

Freigeben über