XMLNode.ValidationStatus プロパティ
追加されたスキーマに基づいて、要素や属性が有効かどうかを指定する値を取得します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)
構文
'宣言
ReadOnly Property ValidationStatus As WdXMLValidationStatus
WdXMLValidationStatus ValidationStatus { get; }
プロパティ値
型 : Microsoft.Office.Interop.Word.WdXMLValidationStatus
WdXMLValidationStatus 値のいずれか。
解説
ValidationStatus プロパティには、次のいずれかの WdXMLValidationStatus 値を指定できます。
wdXMLValidationStatusCustom。SetValidationError メソッドを使用して、ValidationErrorText プロパティにカスタムのテキスト文字列が設定されたことを示します。
wdXMLValidationStatusOK。XML 要素や属性が、追加されたスキーマに基づいて有効であることを示します。
ValidationStatus プロパティに指定できる名前付き定数はこの 2 つしかありませんが、この他にも名前のない値が、Microsoft Office Word に含まれる MSXML 5.0 コンポーネントから多数使用できます。
例
次のコード例は、XMLNode のテキスト値を設定し、Validate メソッドを使用してノードを検証します。次に、ValidationStatus プロパティを使ってノードが有効かどうかを判断します。ノードが有効でない場合は、ValidationErrorText プロパティを使用して検証エラー メッセージを表示します。この例では、現在の文書に CustomerAddress1Node という名前の XMLNode が含まれることが前提となっています。CustomerAddress1Node が整数データ型のスキーマ要素に対応付けられていると、妥当性検査が失敗します。
Private Sub ValidateNode()
Me.CustomerAddress1Node.NodeText = "Nineteen Hundred"
Me.CustomerAddress1Node.Validate()
If Me.CustomerAddress1Node.ValidationStatus = _
Word.WdXMLValidationStatus.wdXMLValidationStatusOK Then
MsgBox("'" & Me.CustomerAddress1Node.BaseName & "' validates.")
Else
MsgBox("'" & Me.CustomerAddress1Node.BaseName & _
"': " & Me.CustomerAddress1Node.ValidationErrorText(False))
End If
End Sub
private void ValidateNode()
{
this.CustomerAddress1Node.NodeText = "Nineteen Hundred";
this.CustomerAddress1Node.Validate();
if (this.CustomerAddress1Node.ValidationStatus ==
Word.WdXMLValidationStatus.wdXMLValidationStatusOK)
{
MessageBox.Show("'" + this.CustomerAddress1Node.BaseName +
"' validates.");
}
else
{
MessageBox.Show("'" + this.CustomerAddress1Node.BaseName +
"': " + this.CustomerAddress1Node.ValidationErrorText[false]);
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。