مشاركة عبر

XMLNode.SetValidationError أسلوب

  • مقالة

قم بتغيير نص التحقق من صحة للخطأ وعرضها لمستخدم XMLNodeعنصر تحكم وإجبار الكلمة Microsoft المكتب 2010 Suite للإبلاغ عن عقدة كصالح.

مساحة الاسم:  Microsoft.Office.Tools.Word
التجميع:  Microsoft.Office.Tools.Word (في Microsoft.Office.Tools.Word.dll)

بناء الجملة

'إقرار
Sub SetValidationError ( _
    Status As WdXMLValidationStatus, _
    ByRef ErrorText As Object, _
    ClearedAutomatically As Boolean _
)

void SetValidationError(
    WdXMLValidationStatus Status,
    ref Object ErrorText,
    bool ClearedAutomatically
)

المعلمات

  • ErrorText
    النوع: System.Object%
    نص المعروض إلى المستخدم.اترك المساحة فارغ عند Statusمعلمة التعيين إلى wdXMLValidationStatusOK.
  • ClearedAutomatically
    النوع: System.Boolean
    trueإلى auإلىmatically مسح رسالة خطأ بمجرد أن يتم إجراء الأحداث التالية للتحقق من الصحة تشغيل العقدة المحددة.falseإلى يتطلب تشغيلSetValidationErrorأسلوب معStatusمعلمةwdXMLValidationStatusOKإلى مسح في نص الخطأ cusإلىm.

ملاحظات

إلى تعيين cusإلىm نص الخطأ، استخدم wdXMLValidationStatusCustomثابت.

المعلمات الإختيارية

ل معلومات تشغيل معلمات اختيارية، راجع يفتقد المتغير و "المعلمات الاختيارية" في حلول Office.

أمثلة

يستخدم المثال تعليمات برمجية التالي SetValidationErrorأسلوب إلى رسالة خطأ التحقق من صحة cusإلىm لتعيين XMLNode. معالج حدث ل ValidationErrorيعرض الحدث مخصص رسالة خطأ التحقق من صحة حالة XMLNodeلا يتحقق من صحة. يفترض هذا المثال الذي مستند الحالي يحتوي على جهازي XMLNodeالكائنات باسم CustomerAddress1Nodeو CustomerZipNodeالتي بتعيينها إلى عناصر المخطط باستخدام على نوع بيانات الأعداد الصحيحة.

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

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]);
}

أمن NET Framework.

راجع أيضًَا

المرجع

XMLNode واجهة

XMLNode الأعضاء

Microsoft.Office.Tools.Word مساحة الاسم