كيفية القيام بما يلي: تمرر وسيطات إلى إجراء بواسطة الاسم
عندما تقوم باستدعاء إجراء Sub أو Function، يمكنك تمرير الوسائط إليه بواسطة الاسم دون اعتبار للترتيب الذي تظهر به المعلمات المتناظرة في تعريف الإجراء.
تمرير الوسائط حسب الاسم يجعل التعليمات البرمجية المستدعية أسهل في القراءة لأنه يعطي معنى إلى قيم الوسيطة في استدعاء الإجراء. إذا كان للإجراء معلمات اختيارية، التمرير حسب الاسم يسهل أيضاً تعقّب الوسيطات التي يتم تمريرها و التي يتم إهمالها.
لقواعد و قيود تزويد الوسائط حسب الاسم, راجع تمرير الوسائط حسب الموضع و حسب الاسم.
لتمرير وسيطة حسب الاسم
فحص التعليمات البرمجية للمصدر لتعريف الإجراء لتحديد هجاء أسماء المعلمات بالضبط.
في التعليمات البرمجية المستدعية، حضر استدعاء الإجراء بالطريقة العادية، مع قائمة الوسائط في أقواس بعد اسم الإجراء.
لكل وسيطة تنوي تمريرها حسب الاسم، قم بتوفير اسم المعلمة المُعلَن متبوعاً بنقطتين وعلامة مساواة (:=) ، متبوعاً بالقيمة التي تمررها للوسيطة.
يمكنك توفير وسائط مسماة بأي ترتيب، لكن يجب عليك توفير كل الوسائط الموضعية قبل توفير أية وسائط مسماة.
مثال
يظهر المثال التالي إجراء Sub بثلاث معلمات، و عبارة استدعاء (Vsual Basic) التي تمرر وسائط إلى هذه المعلمات حسب الاسم.
Sub studentInfo(ByVal name As String,
Optional ByVal age As Short = 0,
Optional ByVal birth As Date = #1/1/2000#)
Debug.WriteLine("Name = " & name &
"; age = " & CStr(age) &
"; birth date = " & CStr(birth))
End Sub
Call studentInfo(age:=19, birth:=#9/21/1981#, name:="Mary")
عندما تقوم بتمرير الوسائط حسب الاسم، لا يتوجب عليك توفيرها بنفس الترتيب الذي يعرفهم به الإجراء.
التحويل البرمجي للتعليمات البرمجية
تأكد من تطابق اسم المعلمة في قائمة الوسائط مع الاسم المعرف بواسطة الإجراء تماماً.
راجع أيضًا:
المهام
كيفية القيام بما يلي: تمرير الوسيطات إلى إجراء
المرجع
المبادئ
تمرير الوسائط بواسطة القيمة و بواسطة المرجع