نکاتی در مورد ELMAH

این نوشته نخستین بار در دات‌نت تیپس منتشر شده است.

سفارشی سازی ایمیل ارسالی :

در مورد ELMAH(Erro Logging Module And Handlers) آقای نصیری چندین مطلب نوشته اند ( + و + و ... )

قبل از ارسال ایمیل توسط ELMAH رخدادی به نام Mailing اجرا (Raise) می‌شود. اگر برای این رخداد یک Event Handler ایجاد کنیم، می‌توانیم جزئیات مربوط به خطایی که قرار است ارسال شود را تغییر دهیم. به عنوان مثال می‌توانیم بگوئیم اگر Error ما از نوع Application Exception بود آنرا به آدرس دیگری ارسال کن و .... برای ایجاد یک Event Handler برای رخداد Mailing ابتدا فایل Global.asax رو به پروژه اضافه کنید و کد زیر را به آن اضافه کنید :

void ErrorMailModuleName_Mailing(object sender, Elmah.ErrorMailEventArgs e)
{
        
}

دقت داشته باشید که در کد فوق به جای ErrorMailModuleName نام HTTPModule را بنویسید، این ماژول در فایل Web.Config قرار دارد :

<httpModules>     
      <add name="ErrorMail" type="Elmah.ErrorMailModule, Elmah" />      
</httpModules>

که در کد فوق ErrorMail می‌باشد در نهایت :

 void ErrorMail_Mailing(object sender, Elmah.ErrorMailEventArgs e)
    {
        
    }

به عنوان مثال در کد زیر اگر Error از نوع Application Exception بود Error Log به آدرس [email protected] نیز ارسال می‌شود :

void ErrorMail_Mailing(object sender, Elmah.ErrorMailEventArgs e)
    {
        if (e.Error.Exception is ApplicationException)
        {
            e.Mail.To.Add("[email protected]");
        }
    }

ذخیره Error‌ها در دیتابیس SQL SERVER :

ELMAH خطاهای Log شده را در جدولی با نام ELMAH_Error ذخیره می‌کند، اگر به داخل پوشه ELMAH توجه کرده باشید یک فایل با نام SQLServer.sql وجود دارد که حاوی اسکریپت مربوط به ساخت جدول فوق می‌باشد. با اجرای این اسکریپت جدول مربوطه همرا با سه SP با نام‌های ELMAH_GetErrorsXml ، ELMAH_GetErrorXml ، ELMAH_LogError ساخته می‌شوند. بعد از ساخت جدول مربوطه باید تگ زیر را در فایل Web.Config بنویسیم :

 <errorLog type="Elmah.SqlErrorLog, Elmah" 
            connectionStringName="..." />

connectionStringName هم نام کانکشن استرینگ را در این قسمت قرار می‌دهیم به عنوان مثال با داشتن کانکشن استرینگ زیر :

<connectionStrings>
    <add name="conn" connectionString="Data Source=.;Initial Catalog=test;User ID=user1;Password=123456;"/>
  </connectionStrings>

به این صورت connectionStringName برابر با مقدار name یعنی conn می‌شود.