XMLNode.SetValidationError(WdXMLValidationStatus, Object, Boolean) Metoda

Reference

Definice

Obor názvů:: Microsoft.Office.Tools.Word

Sestavení:: Microsoft.Office.Tools.Word.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Změní text chyby ověření, který se zobrazí uživateli XMLNode ovládacího prvku, a vynutí, aby Word Microsoft Office ohlásil uzel jako neplatný.

public void SetValidationError(Microsoft.Office.Interop.Word.WdXMLValidationStatus Status, ref object ErrorText, bool ClearedAutomatically = true);

abstract member SetValidationError : Microsoft.Office.Interop.Word.WdXMLValidationStatus * obj * bool -> unit

Public Sub SetValidationError (Status As WdXMLValidationStatus, Optional ByRef ErrorText As Object, Optional ClearedAutomatically As Boolean = true)

Parametry

Status: WdXMLValidationStatus

Jedna z WdXMLValidationStatus hodnot, která určuje, jestli se má nastavit text chyby stavu ověření (wdXMLValidationStatusCustom) nebo vymazat text chyby stavu ověření (wdXMLValidationStatusOK).

ErrorText: Object

Text zobrazený uživateli Pokud je parametr nastavený na hodnotu , ponechte prázdnou Status hodnotu wdXMLValidationStatusOK.

ClearedAutomatically: Boolean

true , aby se chybová zpráva automaticky vymazála, jakmile na zadaném uzlu dojde k další události ověření. false k vyžadování SetValidationError(WdXMLValidationStatus, Object, Boolean) spuštění metody s parametrem Status pro wdXMLValidationStatusOK vymazání vlastního textu chyby.

Příklady

Následující příklad kódu používá metodu SetValidationError k nastavení vlastní ověřovací chybové zprávy pro XMLNode. Obslužná rutina události pro událost ValidationError zobrazí vlastní chybovou XMLNode zprávu ověření, pokud se neověřuje. Tento příklad předpokládá, že aktuální dokument obsahuje dva XMLNode objekty s názvem CustomerAddress1Node a CustomerZipNode které se mapují na prvky schématu s celočíselným datovým typem.

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

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

Poznámky

Pokud chcete nastavit vlastní text chyby, použijte konstantu wdXMLValidationStatusCustom .

Volitelné parametry

Informace o volitelných parametrech najdete v tématu Volitelné parametry v řešeních pro systém Office.

Platí pro

Sdílet prostřednictvím