XMLNode.SetValidationError(WdXMLValidationStatus, Object, Boolean) Yöntem

Tanım

Ad Alanı:

Microsoft.Office.Tools.Word

Bütünleştirilmiş Kod:

Microsoft.Office.Tools.Word.dll

Denetim için XMLNode kullanıcıya görüntülenen doğrulama hata metnini değiştirir ve Microsoft Office Word bir düğümü geçersiz olarak bildirmeye zorlar.

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)

Parametreler

Status

WdXMLValidationStatus

Doğrulama durumu hata metninin WdXMLValidationStatus (wdXMLValidationStatusCustom) ayarlanıp ayarlanmayacağını veya doğrulama durumu hata metninin (wdXMLValidationStatusOK ) temizlenip temizlenmeyeceğini belirten değerlerden biri.

ErrorText

Object

Kullanıcıya görüntülenen metin. parametresi olarak ayarlandığında wdXMLValidationStatusOKboş Status bırakın.

ClearedAutomatically

Boolean

true hata iletisini, belirtilen düğümde bir sonraki doğrulama olayı gerçekleşir gerçekleşmez otomatik olarak temizlemek için. falseözel hata metnini temizlemek için yöntemini parametresiyle StatuswdXMLValidationStatusOK çalıştırmayı SetValidationError(WdXMLValidationStatus, Object, Boolean) zorunlu kılar.

Örnekler

Aşağıdaki kod örneği, bir için özel doğrulama hata iletisi ayarlamak için XMLNodeyöntemini kullanırSetValidationError. Olay için bir olay işleyicisi ValidationError , doğrulanmazsa XMLNode özel doğrulama hata iletisini görüntüler. Bu örnekte, geçerli belgenin adlı CustomerAddress1Node ve CustomerZipNode bir tamsayı veri türüne sahip şema öğeleriyle eşlenen iki XMLNode nesne içerdiği varsayılır.

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

Açıklamalar

Özel hata metni ayarlamak için sabitini wdXMLValidationStatusCustom kullanın.

İsteğe Bağlı Parametreler

İsteğe bağlı parametreler hakkında bilgi için bkz. Office Çözümlerinde İsteğe Bağlı Parametreler.