Udostępnij za pośrednictwem

Metoda XMLNode.SetValidationError —

  • Artykuł

Zmienia tekst błędu sprawdzania poprawności wyświetlane użytkownikowi dla XMLNode kontroli i wymusza programu Microsoft Office Word, aby zgłosić węzeł jako nieprawidłowe.

Przestrzeń nazw:  Microsoft.Office.Tools.Word
Zestaw:  Microsoft.Office.Tools.Word (w Microsoft.Office.Tools.Word.dll)

Składnia

'Deklaracja
Sub SetValidationError ( _
    Status As WdXMLValidationStatus, _
    ByRef ErrorText As Object, _
    ClearedAutomatically As Boolean _
)

void SetValidationError(
    WdXMLValidationStatus Status,
    ref Object ErrorText,
    bool ClearedAutomatically
)

Parametry

  • ClearedAutomatically
    Typ: System.Boolean
    true Aby automatycznie natychmiast po następnym wyczyścić komunikat o błędzie sprawdzania poprawności zdarzenie występuje w określonym węźle. false Aby wymagać pracy SetValidationError metody z Status parametr wdXMLValidationStatusOK ze zwykłym tekstem niestandardowych komunikatów o błędach.

Uwagi

Aby ustawić tekst niestandardowego błędu, należy użyć wdXMLValidationStatusCustom stałych.

Parametry opcjonalne

Informacje na temat parametrów opcjonalnych można wyświetlić na Parametry opcjonalne w rozwiązaniach Office.

Przykłady

Następujący kod w przykładzie wykorzystano SetValidationError metoda, aby ustawić komunikat błędu niestandardowego sprawdzania poprawności dla XMLNode.Moduł obsługi zdarzeń ValidationError zdarzeń wyświetla komunikat błędu niestandardowego sprawdzania poprawności, jeśli XMLNode nie sprawdza poprawności.W tym przykładzie założono, że bieżący dokument zawiera dwa XMLNode obiektów o nazwie CustomerAddress1Node i CustomerZipNode mapowane na elementy schematu z typu danych Liczba całkowita.

Private Sub XMLNodeValidationError()

    ' Set custom error message for Address1 element.
    Dim errorText As String = Me.CustomerAddress1Node.BaseName & _
        " element must be an integer."
    Dim objErrorText As Object = CType(errorText, Object)
    Me.CustomerAddress1Node.SetValidationError( _
        Word.WdXMLValidationStatus.wdXMLValidationStatusCustom, _
        objErrorText, False)

    ' This does not raise a validation error.
    Dim val As Integer = 22222
    Me.CustomerZipNode.NodeText = val.ToString()

    ' This raises a validation error.
    Me.CustomerAddress1Node.NodeText = "Seventeen Hundred Twenty One"
End Sub

Private Sub CustomerNode_ValidationError(ByVal sender As Object, _
    ByVal e As EventArgs) Handles CustomerZipNode.ValidationError, _
    CustomerAddress1Node.ValidationError

    Dim tempNode As Microsoft.Office.Tools.Word.XMLNode = CType(sender,  _
        Microsoft.Office.Tools.Word.XMLNode)
    MsgBox("Error: " & tempNode.ValidationErrorText(False))
End Sub

private void XMLNodeValidationError()
{
    // Set custom error message for Address1 element.
    string errorText = this.CustomerAddress1Node.BaseName + 
        " element must be an integer.";
    object objErrorText = (object)errorText;
    this.CustomerAddress1Node.SetValidationError(
        Word.WdXMLValidationStatus.wdXMLValidationStatusCustom,
        ref objErrorText, false);

    // Attach validation event handlers.
    this.CustomerZipNode.ValidationError +=
        new EventHandler(CustomerNode_ValidationError);
    this.CustomerAddress1Node.ValidationError +=
        new EventHandler(CustomerNode_ValidationError);

    // This does not raise a validation error.
    int val = 22222;
    this.CustomerZipNode.NodeText = val.ToString();

    // This raises a validation error.
    this.CustomerAddress1Node.NodeText = 
        "Seventeen Hundred Twenty One";
}

void CustomerNode_ValidationError(object sender, EventArgs e)
{
    Microsoft.Office.Tools.Word.XMLNode tempNode = 
        (Microsoft.Office.Tools.Word.XMLNode)sender;

    MessageBox.Show("Error: " + tempNode.ValidationErrorText[false]);
}

Zabezpieczenia programu .NET Framework

Zobacz też

Informacje

XMLNode Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Word