פעולת המאקרו ApplyFilter

יש לך אפשרות להשתמש בפעולה ApplyFilter כדי להחיל מסנן, ‏שאילתה או משפט SQL WHERE על טבלה, על טופס או על דוח כדי להגביל או למיין את הרשומות בטבלה, או את הרשומות מהטבלה או השאילתה המשמשת כבסיס של הטופס או הדוח. עבור דוחות, תוכל להשתמש בפעולה זו רק במאקרו שצוין על-ידי מאפיין האירוע OnOpen של הדוח.

הערה: באפשרותך להשתמש בפעולה זו כדי להחיל משפט SQL WHERE רק בעת החלת מסנן שרת. לא ניתן להחיל מסנן שרת על מקור רשומה של פרוצדורה מאוחסנת.

הערה: פעולת המאקרו ApplyFilter אינה זמינה ביישומי Access Web App.

הגדרה

הפעולה ApplyFilter מכילה את הארגומנטים הבאים.

ארגומנט פעולה	תיאור
שם מסנן	שם מסנן או שאילתה להגבלה או למיון של רשומות הטבלה, הטופס או הדוח. באפשרותך להזין את השם של שאילתה קיימת או של מסנן שנשמר כשאילתה בתיבה שם מסנן במקטע ארגומנטים של הפעולה של חלונית בונה המאקרו. הערה: כאשר אתה משתמש בפעולה זו כדי להחיל מסנן שרת, הארגומנט שם מסנן חייב להיות ריק.
תנאי Where	משפט SQL WHERE חוקי (ללא המילה WHERE) או ביטוי המגביל את הרשומות של הטבלה, הטופס או הדוח. הערה: בביטוי ארגומנט של תנאי Where, הצד השמאלי של הביטוי מכיל בדרך כלל שם שדה מהטבלה או השאילתה המשמשת כבסיס עבור הטופס או הדוח. הצד הימני של הביטוי מכיל בדרך כלל את הקריטריונים שברצונך להחיל על שדה זה כדי להגביל או למיין את הרשומות. לדוגמה, הקריטריונים יכולים להיות שמו של פקד בטופס אחר המכיל את הערך שברצונך שהרשומות בטופס ראשון יתאימו לו. שם הפקד צריך להיות שם מלא, לדוגמה: Forms!formname!controlname שמות שדות צריכים להיות מוקפים במירכאות כפולות, וערכים מילוליים של מחרוזת צריכים להיות מוקפים בגרשיים בודדים. האורך המרבי של הארגומנט תנאי Where הוא 255 תווים. אם עליך להזין משפט SQL WHERE ארוך יותר, השתמש בפעולת השירות ApplyFilter של האובייקט DoCmd במודול Visual Basic for Applications ‏(VBA). באפשרותך להזין משפטי SQL WHERE המכילים עד 32,768 תווים ב- VBA.

ארגומנט פעולה

תיאור

שם מסנן

שם מסנן או שאילתה להגבלה או למיון של רשומות הטבלה, הטופס או הדוח. באפשרותך להזין את השם של שאילתה קיימת או של מסנן שנשמר כשאילתה בתיבה שם מסנן במקטע ארגומנטים של הפעולה של חלונית בונה המאקרו.

הערה: כאשר אתה משתמש בפעולה זו כדי להחיל מסנן שרת, הארגומנט שם מסנן חייב להיות ריק.

תנאי Where

משפט SQL WHERE חוקי (ללא המילה WHERE) או ביטוי המגביל את הרשומות של הטבלה, הטופס או הדוח.

הערה: בביטוי ארגומנט של תנאי Where, הצד השמאלי של הביטוי מכיל בדרך כלל שם שדה מהטבלה או השאילתה המשמשת כבסיס עבור הטופס או הדוח. הצד הימני של הביטוי מכיל בדרך כלל את הקריטריונים שברצונך להחיל על שדה זה כדי להגביל או למיין את הרשומות. לדוגמה, הקריטריונים יכולים להיות שמו של פקד בטופס אחר המכיל את הערך שברצונך שהרשומות בטופס ראשון יתאימו לו. שם הפקד צריך להיות שם מלא, לדוגמה:

Forms!formname!controlname

שמות שדות צריכים להיות מוקפים במירכאות כפולות, וערכים מילוליים של מחרוזת צריכים להיות מוקפים בגרשיים בודדים.

האורך המרבי של הארגומנט תנאי Where הוא 255 תווים. אם עליך להזין משפט SQL WHERE ארוך יותר, השתמש בפעולת השירות ApplyFilter של האובייקט DoCmd במודול Visual Basic for Applications ‏(VBA). באפשרותך להזין משפטי SQL WHERE המכילים עד 32,768 תווים ב- VBA.

הערה: באפשרותך להשתמש בארגומנט שם מסנן אם כבר הגדרת מסנן המספק את הנתונים המתאימים. באפשרותך להשתמש בארגומנט תנאי Where כדי להזין את קריטריוני ההגבלה ישירות. אם אתה משתמש בשני הארגומנטים, Access מחיל את משפט WHERE על התוצאות של המסנן. עליך להשתמש באחד מהארגומנטים או בשניהם.

הערות

באפשרותך להחיל מסנן או שאילתה על טופס בתצוגת טופס או בתצוגת גליון נתונים.

המסנן ותנאי WHERE שאתה מחיל הופכים להגדרה של המאפיין Filter או ServerFilter של הטופס או הדוח.

עבור טבלאות וטפסים, פעולה זו דומה ללחיצה על החל סינון/מיון או החל מסנן שרת בתפריט רשומות. פקודת התפריט מחילה את המסנן האחרון שנוצר על הטבלה או הטופס, ואילו הפעולה ApplyFilter מחילה מסנן או שאילתה שצוינו.

במסד נתונים של Access, אם תצביע על מסנן בתפריט רשומות ולאחר מכן תלחץ על סינון/מיון מתקדם לאחר הפעלת הפעולה ApplyFilter, חלון סינון/מיון מתקדם יציג את קריטריוני סינון שבחרת עם פעולה זו.

כדי להסיר מסנן ולהציג את כל הרשומות בטבלה או בטופס במסד נתונים של Access, תוכל להשתמש בפעולה ShowAllRecords או בפקודה הסר סינון/מיון בתפריט רשומות. כדי להסיר מסנן בפרוייקט של Access ‏(‎.adp), באפשרותך לחזור לחלון מסנן שרת לפי טופס ולהסיר את כל קריטריוני הסינון ולאחר מכן ללחוץ על החל מסנן שרת בתפריט רשומות בסרגל הכלים, או להגדיר את המאפיין ServerFilterByForm ל- False ‏(0).

כאשר אתה שומר טבלה או טופס, Access שומר כל מסנן המוגדר כעת באובייקט זה, אך הוא לא מחיל את המסנן באופן אוטומטי בפעם הבאה שהאובייקט נפתח (אף על פי שהוא מחיל באופן אוטומטי כל מיון שהחלת על האובייקט לפני שהוא נשמר). אם ברצונך להחיל מסנן באופן אוטומטי כאשר הטופס נפתח לראשונה, ציין מאקרו המכיל את הפעולה ApplyFilter או פרוצדורת אירוע המכילה את פעולת השירות ApplyFilter של האובייקט DoCmd כהגדרת מאפיין האירוע OnOpen של הטופס. כמו כן, באפשרותך להחיל מסנן על-ידי שימוש בפעולה OpenReport או OpenForm, או באמצעות פעולות השירות התואמות. כדי להחיל מסנן באופן אוטומטי כאשר הטבלה נפתחת לראשונה, באפשרותך לפתוח את הטבלה באמצעות מאקרו המכיל את הפעולה OpenTable, ולאחריה הפעולה ApplyFilter.

דוגמה

החלת מסנן באמצעות מאקרו

המאקרו הבא מכיל ערכה של פעולות, שכל אחת מהן מסננת את הרשומות של טופס רשימת מספרי טלפון של לקוחות. הוא מציג את השימוש בפעולות ApplyFilter, ‏ShowAllRecords ו- GoToControl. הוא גם מציג את השימוש בתנאים לקביעת הלחצן הדו-מצבי שנבחר בקבוצת אפשרויות בטופס. כל שורת פעולה משויכת ללחצן דו-מצבי הבוחר את ערכת הרשומות החל מ- A, ‏B, ‏C וכן הלאה, או את כל הרשומות. יש לצרף מאקרו זה לאירוע AfterUpdate של קבוצת האפשרויות CompanyNameFilter.

תנאי	פעולה	ארגומנטים: הגדרה	הערה
‎[CompanyNameFilters]=1	ApplyFilter	תנאי Where: ‏[CompanyName] כגון "‎[AÀÁÂÃÄ]*‎"	מסנן עבור שמות חברות המתחילים באותיות A, ‏À, ‏Á, ‏Â, ‏Ã או Ä.
‎[CompanyNameFilters]=2	ApplyFilter	תנאי Where: ‏[CompanyName] כגון "B*‎"	מסנן עבור שמות חברות המתחילים באות B.
‎[CompanyNameFilters]=3	ApplyFilter	תנאי Where: ‏[CompanyName] כגון "‎[CÇ]*‎"	מסנן עבור שמות חברות המתחילים באות C או Ç.
... שורות הפעולה של D עד Y מופיעות בתבנית זהה לשורות A עד C ...
‎[CompanyNameFilters]=26	ApplyFilter	תנאי Where: ‏[CompanyName] כגון "‎[ZÆØÅ]*‎"	מסנן עבור שמות חברות המתחילים באותיות Z, ‏Æ, ‏Ø או Å.
‎[CompanyNameFilters]=27	ShowAllRecords		הצג את כל הרשומות.
‎[RecordsetClone].[RecordCount]>0	GoToControl	שם פקד: CompanyName	אם מוחזרות רשומות עבור האות שנבחרה, העבר את המוקד לפקד CompanyName.

הגדרה

הערות

דוגמה

זקוק לעזרה נוספת?

מעוניין באפשרויות נוספות?

האם מידע זה היה שימושי?

תודה על המשוב!