XMLNode.SetValidationError – metoda

Článek
08/11/2011

Změní textchyba ověřovánízobrazen pro uživatel XMLNode řízení a síly systém Microsoft Office Word sestava uzlu 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 nastavit textchyba ověřovánístav( wdXMLValidationStatusCustom) nebo vymazat textchyba ověřovánístav( wdXMLValidationStatusOK).

ErrorText
Typ: System.Object%
Text zobrazený pro uživatel.Ponechte prázdné, pokud Status parametr wdXMLValidationStatusOK.

ClearedAutomatically
Typ: System.Boolean
true událost falsevyžadovat spuštění SetValidationError metoda s Status parametr wdXMLValidationStatusOK zrušte vlastní chyba textu.

Poznámky

Nastavení vlastní chyba textu použijte wdXMLValidationStatusCustom konstantu.

Volitelné parametry

Informace o volitelných parametrů, viz The Variable missing and Optional Parameters in Office Solutions.

Příklady

Následující kód například použití SetValidationErrormetoda ověřovánívlastníchyba zprávu pro nastavení XMLNode. Obslužnou rutinu událost pro ValidationErrorudálost ověřovánívlastníchyba zpráva zobrazí, pokud XMLNode nemá ověřit. Tento příklad předpokládá, že aktuální dokument obsahuje dva XMLNode objekty s názvem CustomerAddress1Node a CustomerZipNode mapa prvků schéma sdatový typ integer.

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é

Odkaz

XMLNode Rozhraní

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

Sdílet prostřednictvím