مشاركة عبر

الحصول على كشف

  • مقالة

يقوم بتعريف خاصية إجراء Get المستخدمة لاسترداد قيمة الخاصية.

[ <attributelist> ] [ accessmodifier ] Get()
    [ statements ]
End Get

الأجزاء

  • attributelist
    اختياري. راجع قائمة سمة.

  • accessmodifier
    اختياري على الأكثر أحد عبارات Get و Set في هذه الخاصية. يمكن أن يكون أحد الخيارات التالية:

    انظر مستويات الوصول في Visual Basic

  • statements
    اختياري. عباره أو أكثر التي يتم تشغيلها عندما يتم استدعاء إجراء خاصية Get .

  • End Get
    مطلوبة. ينهي التعريف لإجراء خاصية Get .

ملاحظات

يجب أن تتضمن كل خاصية إجراء خاصية Get إلا إذا تم وضع الخاصية WriteOnly. الإجراء Get يستخدم لإرجاع قيمة الخاصية الحالية.

يستدعي Visual Basic تلقائياً خاصية إجراء Get عندما يطلب تعبير قيمة الخاصية.

يمكن أن يتضمن نص تعريف الخاصية فقط إجراءات Get و Set للخاصية بين كشف الخاصية و كشف End Property . لا يمكن تخزين شيء أخر غير تلك إجراءات. بشكل خاص، لا يمكن تخزين القيمة الحالية للخاصية . يجب تخزين هذه القيمة خارج الخاصية، لأنه إذا قمت بتخزينها داخل أحد اجرائي في الخاصية ، الإجراء الأخر لا يمكنه الوصول إليها. يعتبر الأسلوب المعتاد هو تخزين القيمة في متغير خاص (Visual Basic) تم تعريفه في نفس المستوى الخاصية. يجب تعريف إجراء Getداخل الخاصية التي ينطبق معها.

إجراء Get يفترض مستوى الوصول للخاصية التي تحتويه إلا إذا كنت تستخدم accessmodifier في عبارة Get .

القواعد

  • مستويات وصول مختلطة. إذا كنت تقوم بتعريف خاصية القراءة / الكتابة يمكنك بشكل اختياري تحديد مستوى مختلف لأحد Get أو إجراء Set ولكن ليس كلاهما. في حالة القيام بهذا مستوى وصول الإجراء يجب أن يكون أكثر تقييداً من مستوى وصول خاصية. على سبيل المثال، إذا تم التصريح عن خاصية Friend، تقوم بتعريف إجراء Get Private، ولكن ليس Public.

    إذا كنت تقوم بتعريف خاصية ReadOnly ، إجراء Get يمثل الخاصية بأكملها. يتعذر تعريف مستوى وصول مختلف ال لـ Get، لأن ذلك سيعين مستويين وصول اثنين للخاصية.

  • نوع الإرجاععبارة الـ كشف الخاصية يمكن أن يعرّف نوع البيانات للقيمة التي يرجعها. الإجراء Get يقوم تلقائياً بإرجاع ذلك نوع البيانات. يمكنك تحديد أي نوع بيانات أو اسم لقائمة تعداد ، فئة، بنية أو واجهة.

    إذا كان عبارة Property لا يحدد returntype، ترجع الإجراء Object.

السلوك

  • الخروج من إجراء. عندما الإجراء Get يقوم بإرجاع استدعاء التعليمات البرمجية ، يستمر التنفيذ داخل العبارة التي طلبتها قيمة الخاصية.

    خاصية الإجراء Get يمكن أن يقوم بإرجاع القيمة باستخدام إما كشف الإرجاع (Visual Basic) أو بواسطة تعيين قيمة الإرجاع إلى اسم الخاصية. لمزيد من المعلومات، راجع "القيمة المرجعة" في كشف دالة (Visual Basic).

    عبارات Exit Property و Return تسبب خروج فوري من إجراء خاصية. أي عدد من عبارات Exit Property و Return يمكن أن تظهر أي مكان في الإجراء، كما يمكن خلط عبارات Exit Property و Return .

  • قيمة الإرجاع. لإرجاع قيمة من الإجراء Get، يمكنك إما تعيين القيمة إلى اسم الخاصية أو تضمينه في العبارة كشف الإرجاع (Visual Basic). العبارة Return تعين في نفس وقت الإجراء Get يرجع القيمة وإنهاء الإجراء.

    إذا كنت تستخدم Exit Property بدون تعيين قيمة إلى Get، إجراء إرجاع قيمة افتراضية لـ "نوع بيانات خاصية. لمزيد من المعلومات، راجع "القيمة المرجعة" في كشف دالة (Visual Basic).

    يوضح المثال التالي طريقتان لخاصية القراءة فقط quoteForTheDay يمكن إرجاع القيمة في متغير خاص quoteValue.

    Private quoteValue As String = "No quote assigned yet."

    ReadOnly Property quoteForTheDay() As String
    Get
        quoteForTheDay = quoteValue
        Exit Property
    End Get
End Property

    ReadOnly Property quoteForTheDay() As String
    Get
        Return quoteValue
    End Get
End Property

مثال

يستخدم المثال التالي عبارة Get لتعيين قيمة الخاصية.

Class propClass
    ' Define a private local variable to store the property value.
    Private currentTime As String
    ' Define the read-only property.
    Public ReadOnly Property dateAndTime() As String
        Get
            ' The Get procedure is called automatically when the
            ' value of the property is retrieved.
            currentTime = CStr(Now)
            ' Return the date and time As a string.
            Return currentTime
        End Get
    End Property
End Class

راجع أيضًا:

المهام

الإرشادات التفصيلية: تعريف الفئات

المرجع

كشف Vsual Basic) Set)

كشف الخاصية

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

موارد أخرى

كائنات و فئات في Visual Basic