XMLNode.SetValidationError(WdXMLValidationStatus, Object, Boolean) 메서드

정의

네임스페이스:

Microsoft.Office.Tools.Word

어셈블리:

Microsoft.Office.Tools.Word.dll

XMLNode 컨트롤에 대해 사용자에게 표시되는 유효성 검사 오류 텍스트를 변경하고 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)

매개 변수

Status

WdXMLValidationStatus

유효성 검사 상태 오류 텍스트를 설정할지(WdXMLValidationStatus) 아니면 유효성 검사 상태 오류 텍스트를 지울지(wdXMLValidationStatusCustom)를 지정하는 wdXMLValidationStatusOK 값 중 하나입니다.

ErrorText

Object

사용자에게 표시되는 텍스트입니다. 매개 변수가 로 Status 설정 wdXMLValidationStatusOK되면 비워 둡니다.

ClearedAutomatically

Boolean

지정된 노드에서 다음 유효성 검사 이벤트가 발생하는 즉시 오류 메시지를 자동으로 지우려면 true입니다. false사용자 지정 오류 텍스트를 지우려면 의 wdXMLValidationStatusOK 매개 변수를 Status 사용하여 메서드를 실행 SetValidationError(WdXMLValidationStatus, Object, Boolean) 해야 합니다.

예제

다음 코드 예제에서는 메서드를 SetValidationError 사용하여 에 대한 XMLNode사용자 지정 유효성 검사 오류 메시지를 설정합니다. 에 유효성을 ValidationError 검사하지 않으면 이벤트에 대한 이벤트 처리기가 사용자 지정 유효성 검사 오류 메시지를 XMLNode 표시합니다. 이 예제에서는 현재 문서에 라는 CustomerAddress1Node 두 개의 XMLNode 개체가 포함되어 있고 CustomerZipNode 정수 데이터 형식의 스키마 요소에 매핑된다고 가정합니다.

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

설명

사용자 지정 오류 텍스트를 설정하려면 상수를 wdXMLValidationStatusCustom 사용합니다.

선택적 매개 변수

선택적 매개 변수에 대한 자세한 내용은 Office 솔루션의 선택적 매개 변수를 참조하세요.