كشف مع... إنهاء مع (Visual Basic)

تنفيذ سلسلة من عبارات إجراء مرجع المتكررة إلى كائن مفرد أو بنيتها.

With object
    [ statements ]
End With

الأجزاء

  • object
    مطلوبة. المتغيّر أو التعبير يمكنك تقييم إلى أي نوع بيانات ، بما في ذلك أنواع أولية.

  • statements
    اختياري. عبارات أو أكثر بين With و End With التي تعمل على object.

  • End With
    مطلوبة. تنهي تعريف المقطع With.

ملاحظات

With...End With يسمح لك لتنفيذ سلسلة من عبارات على كائن محدد دون اعادة تاهيل اسم الكائن. إذا كان مسار الكائن تأهيل طويلاً باستخدام With...End With يمكن تحسين أداء الخاص بك. كتلة With يقلل أيضاً كتابة خطورة الخطأ الاملائي في أحد عناصره ومسار تأهيل المتكررة.

على سبيل المثال، لتغيير عدد الخصائص المختلفة على كائن مفرد ضع عبارات تعيين الخاصية داخل With...End With، الإشارة إلى كائن مرة واحدة فقط عوضاً عن كل تعيين خاصية.

القواعد

  • أنواع البيانات. نوع البيانات object يمكن أن يكون أي فئة أو نوع بنية أو نوع أولية Visual Basic حتى مثل Integer. يدعم برنامج .NET Framework كل الأنواع الأولية مع الفئات أو بنيات يكون الأعضاء يمكنك الوصول إلى داخل كتلة With.

  • التعريف يجب أن تقوم بتعريف object قبل إدخال كتلة With. يتعذر التعريف عليه في عبارة With .

  • **عدد التكرارات.**كتلة With لا يعد إنشاء تكراري. ما لم يكن هناك تكرار حلقي داخل الكتلة, العبارات يتم تشغيلها مرة واحدة فقط.

  • بنيات التداخل. يمكنك إنشاء بنيات With...End With متداخلة بوضع بنيات داخل بنيات أخرى. على سبيل المثال ، راجع كيفية القيام بما يلي: تنفيذ إجراءات متعددة على كائن.

    على الرغم من ذلك، لأن أعضاء عبارات خارجية يتم حجبهم داخل عبارات الداخلي ، يجب توفير مرجع كائن مؤهل بشكل كامل في داخلي كتلة With إلى أي عضو في من كائن في خارجية كتلة With.

    يمكنك أيضا مداخلة أنواع مختلفة من بنيات التحكم داخل بعضها البعض. لمزيد من المعلومات، راجع بنيات التحكم المتداخلة.

  • النقل خارج البنيات. لا يعتمد Visual Basic عبارة الخروج Vsual Basic) ) لنقل عنصر تحكم خارج كتلة With. إذا كنت بحاجة إلى إنهاء قبل أن يتم تنفيذ الكل العبارات وضع التسمية على عبارة End With واستخدام بيان GoTo إلى التفرع إليه. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تسمية البيانات.

    يتعذر عليك نقل عنصر تحكم إما من خارج كتلة With بداخله أو من داخل إلى الخارج. يمكنك استدعاء إجراء من داخل الكتلة, ولكن يعود التحكم إلى العبارة التالية.

  • الوصول إلى كائنات أخرى. بمجرد لقد قمت بإدخال كتلة With , لا يمكن إعادة تعيين object حتى يكون تمرير العبارة End With . لذلك، يمكنك الوصول إلى أساليب وخصائص من فقط المحدد كائن بدون مؤهلة لهم. يمكنك استخدام الأساليب والخصائص الأخرى للكائنات ولكن يجب أن يتأهل مع الخاصة بهم كائن أسماء.

مثال

يستخدم المثال التالي كتلة With لينفذ سلسلة من عبارات على كائن مفرد. المثال يفترض أن كائن testObject تم بالفعل إنشاء ثم عرض الخصائص المشار إليه.

With testObject
    .Height = 100
    .Text = "Hello, World"
    .ForeColor = System.Drawing.Color.Green
    .Font = New System.Drawing.Font(.Font, 
        System.Drawing.FontStyle.Bold)
End With

مع الكلمة الأساسية في المُهيآت كائن

Visual Basic 2008 يقدم استخدام جديد With في المُهيآت الكائن. و لمزيد من المعلومات والأمثلة، راجع مهيئات الكائن أنواع مسماة و مجهولة و أنواع مجهولة .

راجع أيضًا:

المهام

كيفية القيام بما يلي: تنفيذ إجراءات متعددة على كائن

كيفية القيام بما يلي: تسمية البيانات

المرجع

عبارة الخروج Vsual Basic) )

بيان GoTo

المبادئ

بنيات التحكم المتداخلة

مهيئات الكائن أنواع مسماة و مجهولة

أنواع مجهولة