ContentControlBase.Validating الحدث

يحدث عند محتويات المحتوى عنصر تحكم يتم يتم التحقق من صحته.

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

بناء الجملة

'إقرار
Event Validating As CancelEventHandler

event CancelEventHandler Validating

ملاحظات

Validatingحدث هو raهوed عندما يفقد عنصر التحكم تركيز. معالجة Validatingحدث لتحديد ما إذا كان نص في المحتوى التحكم هو صحيح، وفقا للمعايير التي تختارها. ل مثال، إذا كان لديك عنصر تحكم محتوى الذي يحتوي على رقم هاتف، يمكنك التحقق من أن يحتوي على حرف/ حروف المناسبة فقط (أرقام الأقواس والواصلات). إذا كانت المحتويات غير صحيحة، يمكنك إلغاء الأمر حدث والعودة إلى تركيز عنصر تحكم بتعيين Cancelخاصية CancelEventArgsمعلمة معالج الأحداث إلى true. تأثير عملية هو أن مستخدم لا يمكن المغادرة عنصر التحكم إلى أن نص هو صالح.

إلى تشغيل تعليمات برمجية بعد التحقق عنصر تحكم المحتويات بنجاح من، ومعالجة Validatedحدث.

للحصول على مزيد من المعلومات حول معالجة الأحداث، راجع استهلاك الأحداث.

أمثلة

يلي تعليمات برمجية يوضح المثال معالجات الأحداث ل Validatingو Validatedالأحداث. بعد مستخدم النهائي تغيير نص في المحتوى عنصر تحكم، معالج الأحداث Validatingحدث يستخدم تعبير عادي للتأكد من أن نص لا يحتوي على إعداد صحيحة.

يفترض هذا المثال أن يحتوي مستند على PlainTextContentControlباسم plainTextContentControl1. لاستخدام هذا تعليمات برمجية، لصقه في ThisDocumentالفئة في مشروع الخاص بك. C#، يجب يرفق حدث معالجات إلى Validatedو Validatingحدث s من plainTextContentControl1.

Th هو المثال هو لتخصيص المستوى مستند.

Private Sub plainTextContentControl1_Validating(ByVal sender As Object, _
    ByVal e As System.ComponentModel.CancelEventArgs) _
    Handles PlainTextContentControl1.Validating

    Dim control As Microsoft.Office.Tools.Word.PlainTextContentControl = _
        TryCast(sender, Microsoft.Office.Tools.Word.PlainTextContentControl)

    If control IsNot Nothing Then
        Dim regex As New System.Text.RegularExpressions.Regex("\d")
        If regex.IsMatch(control.Text) Then
            MessageBox.Show("Invalid name. Names cannot contain integers.")
            e.Cancel = True
        End If
    End If
End Sub

Private Sub plainTextContentControl1_Validated(ByVal sender As Object, ByVal e As System.EventArgs) _
    Handles PlainTextContentControl1.Validated

    MessageBox.Show("The name is valid.")
End Sub

void plainTextContentControl1_Validating(object sender, System.ComponentModel.CancelEventArgs e)
{
    Microsoft.Office.Tools.Word.PlainTextContentControl control =
        sender as Microsoft.Office.Tools.Word.PlainTextContentControl;

    if (control != null)
    {
        System.Text.RegularExpressions.Regex regex = new System.Text.RegularExpressions.Regex(@"\d");
        if (regex.IsMatch(control.Text))
        {
            MessageBox.Show("Invalid name. Names cannot contain integers.");
            e.Cancel = true;
        }
    }
}

void plainTextContentControl1_Validated(object sender, EventArgs e)
{
    MessageBox.Show("The name is valid.");
}

أمن NET Framework.

• الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.

راجع أيضًَا

المرجع

ContentControlBase واجهة

ContentControlBase الأعضاء

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