XMLNode.SetValidationError(WdXMLValidationStatus, Object, Boolean) Método

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Word

Ensamblado:: Microsoft.Office.Tools.Word.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Cambia el texto del error de validación mostrado a un usuario para un control XMLNode y obliga a Microsoft Office Word a que informe de que un nodo no es válido.

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)

Parámetros

Status: WdXMLValidationStatus

Uno de los valores WdXMLValidationStatus que especifica si se debe establecer el texto del error de estado de validación (wdXMLValidationStatusCustom) o borrarlo (wdXMLValidationStatusOK).

ErrorText: Object

Texto mostrado al usuario. Deje en blanco cuando el Status parámetro esté establecido wdXMLValidationStatusOKen .

ClearedAutomatically: Boolean

true para borrar el mensaje de error automáticamente en cuanto el siguiente evento de validación aparezca en el nodo especificado. false para requerir la ejecución del SetValidationError(WdXMLValidationStatus, Object, Boolean) método con un Status parámetro de wdXMLValidationStatusOK para borrar el texto de error personalizado.

Ejemplos

En el ejemplo de código siguiente se usa el SetValidationError método para establecer un mensaje de error de validación personalizado para .XMLNode Un controlador de eventos para el ValidationError evento muestra el mensaje de error de validación personalizada si XMLNode no lo valida. En este ejemplo se supone que el documento actual contiene dos XMLNode objetos denominados CustomerAddress1Node y CustomerZipNode que se asignan a elementos de esquema con un tipo de datos entero.

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

Comentarios

Para establecer texto de error personalizado, use la wdXMLValidationStatusCustom constante .

Parámetros opcionales

Para obtener información sobre los parámetros opcionales, vea Parámetros opcionales en soluciones de Office.

Se aplica a

Share via