ฟังก์ชัน Filter

นำไปใช้กับ
Access for Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

ส่งกลับอาร์เรย์ที่ยึดตามศูนย์ที่มีเซตย่อยของอาร์เรย์สตริงตามเกณฑ์ตัวกรองที่ระบุ

ไวยากรณ์

Filter(sourcearray, match [, include ] [, compare ] )

ไวยากรณ์ของฟังก์ชัน Filter มีอาร์กิวเมนต์ดังนี้

อาร์กิวเมนต์ คำอธิบาย
sourcearray จำเป็น อาร์เรย์มิติเดียวของสตริงที่จะค้นหา
ตรง กัน จำเป็น สตริงที่จะค้นหา
รวม ไม่จำเป็น ค่าบูลีนระบุว่าจะส่งกลับสตริงย่อยที่รวมหรือไม่รวมรายการที่ตรงกัน ถ้า include เป็น TrueFilter จะส่งกลับเซตย่อยของอาร์เรย์ที่มี ค่าที่ตรงกัน เป็นสตริงย่อย ถ้า include เป็น FalseFilter จะส่งกลับเซตย่อยของอาร์เรย์ที่ไม่ ตรงกัน กับสตริงย่อย
เปรียบ เทียบ ไม่จำเป็น ค่าตัวเลขที่ระบุชนิดของการเปรียบเทียบสตริงที่จะใช้ ดูส่วนการตั้งค่าสําหรับค่า

การตั้งค่า

อาร์กิวเมนต์ เปรียบเทียบ สามารถมีค่าต่อไปนี้:

คง ค่า คำอธิบาย
vbUseCompareOption –1 ทําการเปรียบเทียบโดยใช้การตั้งค่าคําสั่งเปรียบเทียบตัวเลือก
vbBinaryCompare 0 ทําการเปรียบเทียบแบบไบนารี
vbTextCompare 1 ทําการเปรียบเทียบเป็นข้อความ

ข้อสังเกต

ถ้าไม่พบรายการ ที่ตรงกัน ภายใน sourcearrayFilter จะส่งกลับอาร์เรย์ที่ว่างเปล่า ข้อผิดพลาดจะเกิดขึ้นถ้า sourcearray เป็น Null หรือไม่ใช่อาร์เรย์แบบมิติเดียว

อาร์เรย์ที่ส่งกลับโดยฟังก์ชัน Filter มีองค์ประกอบที่เพียงพอที่จะมีจํานวนรายการที่ตรงกันเท่านั้น