XMLNode.SetValidationError(WdXMLValidationStatus, Object, Boolean) Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Word

Assembly:: Microsoft.Office.Tools.Word.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica il testo dell'errore di convalida visualizzato all'utente per un controllo XMLNode e impone la segnalazione della non validità di un nodo da parte di Microsoft Office Word.

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)

Parametri

Status: WdXMLValidationStatus

Uno dei valori WdXMLValidationStatus che specifica se impostare il testo di errore dello stato di convalida (wdXMLValidationStatusCustom) o se cancellarlo (wdXMLValidationStatusOK).

ErrorText: Object

Testo visualizzato all'utente. Lasciare vuoto quando il Status parametro è impostato su wdXMLValidationStatusOK.

ClearedAutomatically: Boolean

true per cancellare automaticamente il messaggio di errore non appena si verifica il successivo evento di convalida nel nodo specificato. false per richiedere l'esecuzione del SetValidationError(WdXMLValidationStatus, Object, Boolean) metodo con un Status parametro di wdXMLValidationStatusOK per cancellare il testo dell'errore personalizzato.

Esempio

Nell'esempio di codice seguente viene utilizzato il SetValidationError metodo per impostare un messaggio di errore di convalida personalizzato per un oggetto XMLNode. Se non viene convalidato, un gestore eventi per l'evento ValidationError visualizza il messaggio XMLNode di errore di convalida personalizzato. In questo esempio si presuppone che il documento corrente contenga due XMLNode oggetti denominati CustomerAddress1Node e CustomerZipNode che eseseguono il mapping agli elementi dello schema con un tipo di dati Integer.

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

Commenti

Per impostare il testo dell'errore personalizzato, usare la wdXMLValidationStatusCustom costante .

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere parametri facoltativi nelle soluzioni Office.

Si applica a

Share via