Freigeben über


XMLNode.ValidationErrorText-Eigenschaft

Ruft eine Zeichenfolge ab, die die Beschreibung eines Validierungsfehlers für ein XMLNode-Steuerelement darstellt.

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

Syntax

'Declaration
ReadOnly Property ValidationErrorText As XMLNode_ValidationErrorTextType
XMLNode_ValidationErrorTextType ValidationErrorText { get; }

Eigenschaftswert

Typ: Microsoft.Office.Tools.Word.XMLNode_ValidationErrorTextType
Eine Zeichenfolge, die die Beschreibung eines Validierungsfehlers für ein XMLNode-Steuerelement darstellt.

Hinweise

Die ValidationErrorText-Eigenschaft ist zur Verwendung mit dem folgenden Parameter vorgesehen.

Parameter

Beschreibung

Advanced

true, um die erweiterte Version der Beschreibung des Validierungsfehlers anzuzeigen, die aus der in Microsoft Office Word enthaltenen Komponente MSXML 5.0 stammt, andernfalls false.

Wenn Sie die ValidationErrorText-Eigenschaft ohne angegebenen Parameter verwenden, gibt sie ein XMLNode_ValidationErrorTextType-Objekt zurück, das nicht für die direkte Verwendung in Code vorgesehen ist.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

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

Siehe auch

Referenz

XMLNode Schnittstelle

Microsoft.Office.Tools.Word-Namespace