إرجاع صفيف يستند إلى صفر يحتوي على مجموعة فرعية من صفيف سلسلة استنادا إلى معايير تصفية محددة.
بناء الجملة
Filter( sourcearray , match [, include ] [, compare ] )
يحتوي بناء جملة دالة عامل التصفية على هذه الوسيطات:
|
الوسيطة |
الوصف |
|
sourcearray |
مطلوبة. صفيف أحادي الأبعاد من السلاسل التي سيتم البحث فيها. |
|
المباراه |
مطلوبة. سلسلة للبحث عن. |
|
تضمين |
اختيارية. قيمة منطقية تشير إلى ما إذا كنت تريد إرجاع السلاسل الفرعية التي تتضمن المطابقة أو تستبعدها. إذا كان includeهو True، فترجع عامل التصفية المجموعة الفرعية للصفيف الذي يحتوي على مطابقة ك سلسلة فرعية. إذا كان include هو False، فترجع عامل التصفية المجموعة الفرعية للصفيف الذي لا يحتوي على تطابق ك سلسلة فرعية. |
|
مقارنه |
اختيارية. قيمة رقمية تشير إلى نوع مقارنة السلسلة المراد استخدامها. راجع قسم الإعدادات للقيم. |
الإعدادات
يمكن أن تحتوي وسيطة المقارنة على القيم التالية:
|
ثابت |
قيمة |
الوصف |
|
vbUseCompareOption |
–1 |
إجراء مقارنة باستخدام إعداد عبارة Option Compare . |
|
vbBinaryCompare |
0 |
إجراء مقارنة ثنائية. |
|
vbTextCompare |
1 |
إجراء مقارنة نصية. |
|
vbDatabaseCompare |
2 |
Microsoft Office Access 2007 فقط إجراء مقارنة استنادا إلى المعلومات الموجودة في قاعدة البيانات الخاصة بك. |
ملاحظات
إذا لم يتم العثور على تطابقات للمطابقة داخل sourcearray، يقوم عامل التصفية بإرجاع صفيف فارغ. يحدث خطأ إذا كان sourcearrayفارغا أو لم يكن صفيفا أحادي الأبعاد.
يحتوي الصفيف الذي تم إرجاعه بواسطة الدالة Filter على عناصر كافية فقط لاحتواء عدد العناصر المتطابقة.
