XMLNode.SetValidationError(WdXMLValidationStatus, Object, Boolean) 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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 -> unitPublic 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 솔루션의 선택적 매개 변수를 참조하세요.