الدالة Array

ينطبق على
Access لـ Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

ترجع أ Variant يحتوي على صفيف.

بناء الجملة

Array(arglist)

الوسيطة المطلوبة arglist هي قائمة محددة بفواصل من القيم المعينة لعناصر الصفيف في .Variant إذا لم تحدد أي وسيطات، فسيقوم Access بإنشاء صفيف فارغ.

ملاحظات

للإشارة إلى عنصر في صفيف، استخدم اسم المتغير متبوعا بأقواس تحتوي على رقم الفهرس الخاص بالعنصر الذي تريده. في المثال التالي، تنشئ العبارة الأولى متغيرا اسمه AVariant. تقوم العبارة الثانية بتعيين صفيف إلى A. تقوم العبارة الأخيرة بتعيين القيمة الموجودة في عنصر الصفيف الثاني إلى متغير آخر.

ملاحظة

توضح الأمثلة التالية كيفية استخدام هذه الدالة في وحدة نمطية في Visual Basic for Applications (VBA). لمزيد من المعلومات حول استخدام VBA، حدد "مرجع المطور" في القائمة المنسدلة بجوار "بحث"، ثم أدخل مصطلح أو أكثر في مربع البحث.

Dim A As Variant
A = Array(10,20,30)
B = A(2)

يتم تحديد الحد الأدنى لصفيف تم إنشاؤه بواسطة Array الدالة بواسطة الحد الأدنى المحدد بواسطة العبارة Option Base ، ما لم Array يكن مؤهلا باسم مكتبة النوع، مثل VBA.Array. إذا قمت بتأهيله باستخدام اسم مكتبة النوع، Array فلن يتأثر ب Option Base.

ملاحظة

A Variant الذي لم يتم الإعلان عنه كصفيف لا يزال بإمكانه أن يحتوي على صفيف. يمكن أن يحتوي المتغير Variant على صفيف من أي نوع باستثناء السلاسل ثابتة الطول والأنواع المعرفة من قبل المستخدم. تختلف البيانات التي Variant تحتوي على صفيف من الناحية المفاهيمية عن الصفيف الذي تكون عناصره من النوع Variant، ولكنك يمكنك الوصول إلى عناصر الصفيف بالطريقة نفسها.

مثال

يستخدم هذا المثال الدالة Array لإرجاع A Variant يحتوي على صفيف.

Dim MyWeek, MyDay
MyWeek = Array("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
' Return values assume the lower bound is set to 1 by using the
' Option Base statement.
MyDay = MyWeek(2)    ' MyDay contains "Tue".
MyDay = MyWeek(4)    ' MyDay contains "Thu".