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


דרישות:
Visual Basic 2005 בכל המהדורות.
במידה ואין לכם את Visual Basic 2005, ניתן להוריד בחינם את מהדורת ה-Express (עד לתאריך 6/11/2006), מכאן.


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

ל-VB 2005 מצורפים גזירי קוד רבים המוכנים לשימוש מיידי בעורך הקוד (כולל במהדורת ה-Express הכוללת 233 גזירי קוד).
כדי לצפות בגזירי הקוד הזמינים אצלכם, פתחו את VB 2005 ובחרו מהתפריט Tools ב-Code Snippets Manager.
בחלון שיפתח יוצגו בפניכם קטגוריות גזירי הקוד, כאשר בכל קטגוריה תוכלו לראות את גזירי הקוד השייכים אליה (לעתים יש תתי קטגוריות בקטגוריות עצמן):


השימוש בגזירי קוד
הדרך הטובה ביותר להבין את גזירי הקוד (וזה פשוט מאוד), היא פשוט להתחיל להשתמש בהם:
1. פתחו פרוייקט חדש מסוג Windows Application בויזואל בייסיק 2005.
2. לשם ההדגמה נוסיף כפתור פקודה (Button) לטופס מתיבת הכלים.
3. לחצו לחיצה כפולה על הכפתור שהוספנו.
4. עורך הקוד יפתח באירוע לחיצה על הכפתור - Button1_Click
5. כעת הגענו לחלק של הוספת גזיר הקוד.
יש בפנינו 2 דרכים עיקריות להוספת גזיר הקוד:
א. על ידי לחיצה על כפתור הימני של העכבר ובחירה ב-Insert Snippet מהתפריט שיפתח:

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

ניתן לנווט בין גזירי הקוד, ובצורה זו לגלות אילו גזירי קוד עומדים לרשותנו (בדומה ל-Code Snippet Manager אותו פגשנו בתחילת המאמר).
כדי להתקדם בתוך הקטגוריה יש ללחוץ לחיצה כפולה על הכפתור השמאלי של העכבר (או באמצעות המקשים Enter או Tab).
כדי לחזור רמה אחת למעלה (אחורה) יש ללחוץ על מקש המחיקה (Backspace).
בחירת גזיר קוד רצוי, נעשית גם היא על ידי לחיצה כפולה על כפתור העכבר, או באמצעות המקשים Enter או Tab (בחרו בצורה שהכי נוחה לכם).

כאשר סמן העכבר נמצא מעל גזיר קוד מסוים, מופיע ב-Tooltip (המלבן הצהוב) הסבר קצר מה עושה אותו גזיר קוד. כמו כן, מופיע קיצור דרך לאותו גזיר קוד (mathTan לגזיר הקוד שבדוגמה):
למשל נבחר את גזיר הקוד המחשב את הטנגנס (היחס בין הניצב לצלע במשולש) של זווית מסוימת (גזיר הקוד הזה נדרש, הואיל ו-VB מחשבת טנגנס עבור רדיאנים ולא עבור מעלות).
בחירת גזיר הקוד תתבצע, כאמור, על ידי לחיצה כפולה עליו (או לחיצה על המקש Enter או Tab):

Dim radians As Double = 120 * Math.PI / 180 Dim tan As Double = Math.Tan(radians)

הקוד שנוסף לנו הוא גזיר הקוד.
הקטע המסומן ברקע ירוק הוא הקטע שעלינו להחליף בהתאם לקוד שלנו.
אם נעביר את סמן העכבר מעל הקטע המסומן בירוק, נראה Tooltip בו כתוב: Replace with the measurement in degrees, כלומר יש לכתוב במקום מה שכתוב בירוק, את הזווית במעלות שאת הטנגנס שלה אנו רוצים לחשב.
נכתוב 45 במקום המסומן בירוק ונוסיף שורה להצגת התוצאה בתיבת הודעה (MsgBox):

Dim radians As Double = 45 * Math.PI / 180 Dim tan As Double = Math.Tan(radians) MsgBox(tan)

נריץ את התוכנית (למשל: על ידי לחיצה על המקש F5, או על ידי לחיצה על הכפתור Start Debugging  מסרגל הכלים).
נלחץ על כפתור הפקודה והתוצאה שתוצג לנו היא 1 (התוצאה של טנגנס זווית של 45 מעלות).


קיצור דרך לגזיר קוד
אם אתם זוכרים ב-Tooltip ליד גזיר הקוד שבו השתמשנו הרגע, הופיע קיצור הדרך - mathTan.
אם נרצה להשתמש בפעם אחרת באותו גזיר הקוד ובמידה ונזכור את קיצור הדרך, נוכל פשוט לכתוב  mathTan וללחוץ על מקש ה-Tab וגזיר הקוד יופיע (בלא צורך לנווט אליו).
במידה ואנו לא זוכרים את כל קיצור הדרך, אלא רק שהוא מתחיל במילה math, נוכל לרשום את המילה math ומייד לאחריה ? (סימן שאלה) ואז נלחץ על Tab ויופיע לנו תפריט ממנו נוכל לבחור את גזיר הקוד הרצוי.


דוגמה נוספת - גזיר קוד לשליחת דואר אלקטרוני
נוסיף גזיר קוד חדש (על ידי כתיבת ? ולחיצה על מקש ה-Tab או על ידי לחיצה על הכפתור הימני של העכבר ובחירה ב-Insert Snippet).
הפעם ננווט לקטגוריה Connectivity and Networking ונבחר בגזיר הקוד Create an Email Message.

הערה: את גזיר הקוד ניתן להוסיף, למשל, לאירוע לחיצה על כפתור (Click).

כעת נוסף גזיר הקוד הבא:

Dim message As New MailMessage("sender@address", "from@address", "Subject", "Message Text") Dim emailClient As New SmtpClient("Email Server Name") emailClient.Send(message)

כאשר בגזיר קוד זה ישנם 5 מקומות להחלפה (המסומנים ברקע ירוק).
אם נעביר את סמן העכבר על המקומות המיועדים להחלפה, נוכל לקבל הסבר מה יש לכתוב בכל מקום:
1. במקום הראשון יש לכתוב את כתובת הדואר האלקטרוני של השולח.
2. במקום השני יש לכתוב את כתובת הדואר האלקטרוני של הנמען (לשם ההדגמה, רצוי שזו תהיה כתובת שיש לכם גישה אליה, כדי שתוכלו לבדוק האם אכן הודעת הדואר הגיעה).
3. במקום השלישי יש לכתוב את נושא ההודעה/
4. במקום הרביעי יש לכתוב את התוכן של ההודעה/
5. בשורה השניה יש לכתוב את שם שרת האינטרנט של ספקית האינטרנט שלכם (שבאמצעותו תועבר הודעת הדואר האלקטרוני).

ניווט בין המקומות המיועדים להחלפה: כדי לעבור לפריט הבא להחלפה, יש ללחוץ על מקש ה-Tab. כדי לעבור לפריט הקודם להחלפה, יש ללחוץ על צירוף המקשים Shift+Tab.

כעת נעדכן את המקומות המיועדים להחלפה:

Dim message As New MailMessage("sender@hotmaill.com", _        "recipient@hotmaill.com", "An article about Code Snippets", "Bla, bla, bla...") Dim emailClient As New SmtpClient("mailgw.netvision.net.il") emailClient.Send(message)

הסבר:
1. במקום הראשון קבענו כי כתובת השולח היא sender@hotmaill.com (יש לכתוב כאן כתובת הדואר שלכם).
2. במקום השני קבענו כי ההודעה תישלח לכתובת: recipient@hotmaill.com (יש להחליף את כתובת זו, לכתובת שהינכם מעוניינים שתקבל את הודעת הדואר האלקטרוני).
3. במקום השלישי קבענו כי כותרת ההודעה היא: An article about Code Snippets.
4. במקום הרביעי קבענו את תוכן ההודעה.
5. במקום החמישי רשמנו את שם שרת הדואר היוצא של חברת נטוויז'ן. עליכם להחליף אותו, בשם שרת הדואר של ספקית האינטרנט שלכם (את רשימת שמות שרתי הדואר היוצא של ספקיות האינטרנט השונות בישראל, ניתן למצוא כאן).
נריץ את התוכנית (למשל, על ידי לחיצה על F5) ונשלח את הודעת הדואר.
(הערות: א.שבירת השורה על ידי התו "_" (חוקי גם ב-VB), היא לשם שיפור נוחות הקריאה בלבד. ב. טעות הכתיב hotmaill.com עם שני l, היא מכוונת, על מנת למנוע קצירה של כתובות דואר אלקטרוני).

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


דברים חשובים נוספים בנוגע לגזירי קוד:
1. מציאת ערכים מתאימים להחלפה מתוך התוכנית
לחיצה על צירוף המקשים Ctrl+מקש הרווח - בזמן שנמצאים במקום המיועד להחלפה, יכולה להציג ערכים מהתוכנית המתאימים להשלמה במקום זה (לא בטוח שיש בתוכנית ערכים מתאימים, אבל אם יש ניתן להשתמש בהם).
כמו כן אם גזיר הקוד משתמש בבקר כלשהו, ונלחץ על Ctrl+מקש הרווח - במקום בו כתוב שם הבקר, אז יוצעו לנו בקרים מתאימים מהפרוייקט בהם ניתן לבחור, ואפילו יוצע לנו ליצור בקר חדש.
2. הוספת גזירי קוד ישירות מסייר החלונות
ניתן להוסיף גזירי קוד ישר מסייר החלונות. למשל אם הורדתם גזיר קוד מהאינטרנט ואתם מעוניינים להוסיף אותו לקוד שלכם (בתנאי שהוא בפורמט snippet.), פשוט תגררו אותו למקום הרצוי בעורך הקוד והוא יתווסף אוטומטית לקוד. באופן דומה ניתן לגרור כל גזיר קוד הנמצא אצלכם במחשב (כולל אלו שהותקנו עם ויזואל בייסיק 2005).
3. האם הרקע הירוק בגזיר הקוד ישאר לתמיד?
לא לאחר סגירת הפרוייקט, הרקע הירוק במקומות המיועדים להחלפה יעלם, והמקום בו נוסף גזיר הקוד, יראה כאילו שאתם כתבתם אותו (ללא סימנים כי הקוד נלקח מגזיר קוד).
4. האם ניתן לערוך גזירי קוד קיימים או וליצור גזירי קוד משלי?
כן. עם התקנת VB 2005 נוצרה תת הספריה הבאה Visual Studio 2005\Code Snippets\Visual Basic\My Code Snippets בתוך ספריית ה-My Documents (המסמכים שלי), בה ניתן לשמור גזירי קוד שיצרתם, ערכתם, או הורדתם מהאינטרנט.
מכאן ניתן להוריד את Code Snippet Editor for Visual Basic 2005, שבעזרתו ניתן לערוך גזירי קוד קיימים ואף ליצור גזירי קוד חדשים בקלות יחסית.
למעשה גזירי הקוד הם קבצי XML בעלי סיומת snippet וניתן לערוך אותם בכל עורך XML (או אף בעורך טקסט). כמובן, שנוח ויעיל יותר לערוך אותם בעזרת ה-Code Snippet Editor.
5. במידה וגזיר הקוד דורש הצהרת Imports או Reference מסוים - האם יש צורך להוסיפו ידנית?
לא. במידה וגזיר הקוד דורש הצהרת Import או Reference מסוים - הוא יתווסף אוטומטית עם הוספת גזיר הקוד (אלא אם כן כבר הייתה בפרוייקט הצהרת ה-Imports או ה-Reference הדרושים). בכך ניתן לראות את העוצמה של גזירי הקוד, שמבצעים אוטומטית עבודה רבה הקשורה לשימוש בהם ובכך מקילים בצורה משמעותית על מלאכת התכנות.


מקורות נוספים על גזירי קוד בויזואל בייסיק 2005:

[לחזרה לרשימת המאמרים]