כיצד לעבוד עם NLog ב- .Net

NLog היא פלטפורמת רישום קוד פתוח לשימוש ביישומי .Net, Xamarin ואפילו Windows Phone. זה בחינם, חוצה פלטפורמות וקל להגדרה ולהרחבה. NLog היא פלטפורמת רישום נהדרת ופשוטה ומגיעה עם תמיכה מצוינת ביכולות ניתוב וניהול יומני, מה שהופך אותה לבחירה טובה כשאתה צריך לבחור מסגרת רישום עם ביצועים גבוהים. 

התקן את NLog

ראשית, עליך להוריד עותק של NLog.

לחלופין, ניתן להתקין את NLog באמצעות מנהל החבילות NuGet. לשם כך, כל שעליך לעשות הוא ליצור פרוייקט ב- Visual Studio, ללחוץ לחיצה ימנית על הפרויקט בחלון סייר הפתרונות, ואז לבחור באפשרות "נהל חבילות NuGet ...". לאחר מכן, תוכל לבחור ב- NLog.Config כחבילה שתרצה להתקין מחלון מנהל החבילות NuGet.

לחלופין, תוכל להתקין את NLog באמצעות מסוף מנהל החבילות. הקלד את הפקודה הבאה במסוף מנהל החבילות ולחץ על Enter.

התקנת החבילה NLog.Config

כדי להתחיל להשתמש ב- NLog ב- Visual Studio 2015, באפשרותך להתקין את חבילת NLog.Config. כאשר אתה מתקין חבילה זו, יותקנו גם התלות הקשורה בה, כולל NLog ו- NLog.Schema, והרכבת NLog.dll תתווסף לפרויקט שלך. תראה גם שני קבצים שנוספו לפרויקט שלך, אחד בשם NLog.config ואחד בשם NLog.xsd.

רמות יומן NLog

NLog מספקת תמיכה ברמות היומן הבאות:

  • זֵכֶר
  • לנפות
  • מידע
  • לְהַזהִיר
  • שְׁגִיאָה
  • קָטלָנִי

הגדרת NLog

ראשית יהיה עליך להגדיר את השם והנתיב של קובץ היומן בקובץ NLog.config. כך תוכל לעשות זאת:


  

אם ברצונך ליצור קובץ יומן כל יום, תוכל לציין את הדברים הבאים בתג המשתנה:


  

ציין יעד יומן ב- NLog

לאחר שצוין שם קובץ היומן ונתיבו, עליך לציין יעד יומן. ניתן לעשות זאת באמצעות תג היעד בקובץ NLog.config:

            xsi: type = "File"

            fileName = "$ {logFilePath}"

            layout = "$ {longdate} LEVEL = $ {level: upperCase = true}: $ {message}"

            keepFileOpen = "true" />

שים לב שאתה יכול ליצור מספר יעדים בתוך תגית היעדים.

אתה יכול גם לנצל את הכללים כדי לאפשר ל- NLog לדעת היכן יש לרשום רשומת יומן מסוימת, בין אם בקובץ, בסיס נתונים, ביומן אירועים וכו '.

צור לוגר ב- NLog

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

מרחב שמות לדוגמא

{

  מבחן בכיתה ציבורית

  {

    לוגר לוגר סטטי פרטי = LogManager.GetCurrentClassLogger ();

  }

}

אם ברצונך לאחזר לוגר מסוים, תוכל לנצל את שיטת GetLogger של מחלקת LogManager כמוצג להלן.

שימוש ב- NLog;

לוגר לוגר = LogManager.GetLogger ("SpecifyTheClassNameHere");

דוגמה פשוטה ל- NLog ב- .Net

הנה התוכנית המלאה לעיונך המדגימה כיצד ניתן להשתמש ב- NLog לרישום נתונים ברמות שונות.

שימוש ב- NLog;

באמצעות מערכת;

מרחב שמות NLog

{

    תכנית כיתתית

    {

        לוגר לוגר סטטי פרטי = LogManager.GetCurrentClassLogger ();

        ריק סטטי ראשי (מחרוזת [] טענות)

        {

            logger.Trace ("זוהי הודעת מעקב");

            logger.Debug ("זו הודעת ניפוי באגים");

            logger.Info ("זוהי הודעת מידע");

            logger.Warn ("זוהי הודעת אזהרה");

            logger.Error ("זו הודעת שגיאה");

            logger.Fatal ("זו הודעה קטלנית");

            Console.ReadKey ();

        }

    }

}