XMLNode.ValidationStatus-Eigenschaft

Artikel
01/03/2014

Ruft einen Wert ab, der angibt, ob ein Element oder Attribut gemäß dem angefügten Schema gültig ist.

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

Syntax

'Declaration
ReadOnly Property ValidationStatus As WdXMLValidationStatus

WdXMLValidationStatus ValidationStatus { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Word.WdXMLValidationStatus
Einer der WdXMLValidationStatus-Werte.

Hinweise

Die ValidationStatus-Eigenschaft kann einen der folgenden WdXMLValidationStatus-Werte besitzen:

wdXMLValidationStatusCustom gibt an, dass die ValidationErrorText-Eigenschaft mithilfe der SetValidationError-Methode auf eine benutzerdefinierte Textzeichenfolge festgelegt wurde.
wdXMLValidationStatusOK gibt an, dass ein XML-Element oder XML-Attribut gemäß dem angefügten Schema gültig ist.

Dies sind die beiden einzigen benannten Konstanten, die für die ValidationStatus-Eigenschaft zulässig sind. Darüber hinaus gibt es jedoch zahlreiche nicht benannte Werte, die aus der in Microsoft Office Word enthaltenen Komponente MSXML 5.0 stammen.

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