XMLNode.SetValidationError – metoda

Článek
01/03/2014

Změní text chyby ověřování zobrazí uživateli pro XMLNode řízení a přinutí aplikaci Microsoft Office Word zprávu jako neplatný uzel.

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
Více WdXMLValidationStatus hodnoty, které určuje, zda chcete-li nastavit text chyby ověření stavu (wdXMLValidationStatusCustom) nebo vymazat text chyby ověření stavu (wdXMLValidationStatusOK).

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

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

Poznámky

Nastavit text vlastní chyby, použijte wdXMLValidationStatusCustom konstantní.

Volitelné parametry

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

Příklady

Následující příklad kódu používá SetValidationError metoda pro nastavení vlastní ověřovací zprávu Chyba XMLNode.Obslužné rutiny události ValidationError události vlastní ověření chybová zpráva zobrazí, 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 s celočíselným datovým typem.

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