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

مقالة
11/01/2010

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

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

الأجزاء

attributelist
اختياري. راجع قائمة سمة.
accessmodifier
اختياري على الأكثر أحد عبارات Get و Set في هذه الخاصية. يمكن أن يكون أحد الخيارات التالية:
- محمي
- صديق
- Private
- Protected Friend
انظر مستويات الوصول في 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

راجع أيضًا:

Share via

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

الأجزاء

ملاحظات

القواعد

السلوك

مثال

راجع أيضًا:

المهام

المرجع

موارد أخرى

الموارد الإضافية