XMLNode.SetValidationError – metoda

Článek
05/14/2013

Změní text chyby ověřování zobrazí uživateli pro XMLNode řízení a způsobí, že aplikace Microsoft Office Word zprávu uzel jako neplatné.

Obor názvů: Microsoft.Office.Tools.Word
Sestavení: Microsoft.Office.Tools.Word (v Microsoft.Office.Tools.Word.dll)

Syntaxe

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

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

Parametry

Status
Typ: Microsoft.Office.Interop.Word.WdXMLValidationStatus
Jeden z WdXMLValidationStatus hodnoty, které určuje, zda chcete-li nastavit text ověření stavu chyby (wdXMLValidationStatusCustom) nebo chcete-li vymazat text ověření stavu chyby (wdXMLValidationStatusOK).

ErrorText
Typ: System.Object%
Text zobrazený uživateli.Ponechejte prázdné, pokud Status parametr nastaven na wdXMLValidationStatusOK.

ClearedAutomatically
Typ: System.Boolean
true jako další brzy automaticky zrušte chybová zpráva ověření události v určeném uzlu. false vyžadovat spuštění SetValidationError metodu s Status parametr wdXMLValidationStatusOK Chcete-li vymazat text vlastní chyby.

Poznámky

Chcete-li nastavit text vlastní chybové zprávy, použijte wdXMLValidationStatusCustom konstantní.

Volitelné parametry

Informace o volitelných parametrů naleznete v tématu Volitelné parametry v Office Solutions.

Příklady

Následující příklad kódu používá SetValidationError metoda nastavit chybovou zprávu vlastní ověřování pro XMLNode.Obslužné rutiny události ValidationError události zobrazí chybovou zprávu vlastního ověřování, pokud XMLNode neověřuje.Tento příklad předpokládá, že aktuální dokument obsahuje dva XMLNode objekty s názvem CustomerAddress1Node a CustomerZipNode , mapovat prvky schématu datového typu celé číslo.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

XMLNode Rozhraní

Microsoft.Office.Tools.Word – obor názvů

Sdílet prostřednictvím