ASP.NET企业开发框架IsLine FrameWork系列之十五--框架配置信息大全(下)

最新推荐文章于 2020-05-28 10:24:00 发布

转载最新推荐文章于 2020-05-28 10:24:00 发布 · 847 阅读

框架专栏收录该内容

29 篇文章

订阅专栏

ASP.NET企业开发框架IsLine FrameWork系列之十五--框架配置信息大全(下)

接上文

三．IsLine.ExceptionProcess 部分

这部分主要管理异常，对异常的管理分为两部分，异常记录和异常展现，你可以分开对其进行配置，即异常的记录与展现之间互不影响。

关于异常记录：

   
    <
    add key
    =
    "
    IsLine.ExceptionProcess.Configuration.RenderName
    "
     value
    =
    "
    OracleUsingSPRender
    "
    />

使用该信息指定记录异常的节点，“OracleUsingSPRender”为上面介绍过的“<IsLine.AppLog.Configuration>”中的一个节点。当然你可以自定义节点或选择其他内置节点，然后在这里使用。

对于异常信息的记录，有一个超级日常功能可以开启，即这个功能是记录那些，记录异常信息时发生的异常，这个异常信息只能记录至文本文件中，你可以通过以下节点开启并配置它：

Step 1.开启超级异常模块

   
    <
    add key
    =
    "
    IsLine.ExceptionProcess.ExceptionProcessProvider.IsOpenDebugInfo
    "
     value
    =
    "
    True
    "
     
    />

Step 2.指定异常文件位置

   
    <
    add key
    =
    "
    IsLine.ExceptionProcess.ExceptionProcessProvider.DebugInfo
    "
     
value
    =
    "
    C:\IsLineLog\FinallyLog.txt
    "
     
    />

关于异常展现：

异常发生后如何将其展现给用户，IsLine FrameWork内置了10中异常展示方法，你可以通过以下选项来配置它：

   
    <
    add key
    =
    "
    IsLine.ExceptionProcess.Configuration.ProcessStyle
    "
     value
    =
    "
    ShowSimpleWithLog
    "
    />

“ShowSimpleWithLog”为异常展示的枚举值，这些值决定异常将以何种外观展示给用户，这些枚举值还包括：

枚举值	作用
ThrowOriginalWithLog	抛出原始错误，终止应用程序，并将这种错误记录到异常日志中。
ThrowOriginalWithoutLog	只是抛出原始错误，终止应用程序，并不记录这种错误
ThrowFriendlyWithLog	抛出友好的错误信息，终止应用程序，并记录异常
ThrowFriendlyWithoutLog	抛出友好的错误信息，终止应用程序，并不记录异常
ThrowSimpleWithLog	抛出简单的预定义的错误信息，终止应用程序，并记录异常
ThrowSimpleWithoutLog	抛出简单的预定义的错误信息，终止应用程序，并不记录异常
ShowSimpleWithLog	显示简单的预定义的错误信息，不终止应用程序，并记录异常
ShowSimpleWithoutLog	显示简单的预定义的错误信息，不终止应用程序，并不记录异常
HideWithLog	不显示任何错误信息，不终止应用程序，并将异常信息记录
HideWithoutLog	不显示任何错误信息，不终止应用程序，并不记录异常信息

注意：

1.当使用“ThrowSimpleWithLog”或“ThrowSimpleWithoutLog”枚举值时，可以通过以下方式设置抛出的简单信息：

   
    <
    add key
    =
    "
    IsLine.ExceptionProcess.ExceptionProcessProvider.FriendlySimpleText
    "

     value
    =
    "
    The current page has an exception!
    "
    />

其中的"The current page has an exception!"即为发生异常时系统抛出的内容。

设置后，抛出的异常信息如下图所示：

2.当使用“ThrowFriendlyWithLog”或“ThrowFriendlyWithoutLog”枚举值时，可以通过以下方式设置抛出的友好信息，这个设置决定了异常抛出的格式以及内容：

Step 1.在<configSections>与</configSections>中加入：

   
    <
    sectionGroup name
    =
    "
    IsLine.ExceptionProcess.Configuration
    "
    >
         
   
    <
    section name
    =
    "
    ILExceptionModel
    "
     type
    =
    "
    IsLine.Data.Configuration.SuitConfig
    "
     
    />
</
    sectionGroup
    >

Step 2.在</configSections>后加入：(注意，以下配置与sectionGroup一一对应)

   
  
代码 
   
     <
     IsLine.ExceptionProcess.Configuration
     >
     

              
     <
     ILExceptionModel
     >
     

                     
     <
     Message
     >-&
     gt;Message：@Message
     </
     Message
     >
     

                     
     <
     Level
     >-&
     gt;Level：@Level
     </
     Level
     >
     

                     
     <
     HelpLink
     >-&
     gt;Helper：@HelpLink
     </
     HelpLink
     >
     

                     
     <
     Source
     >-&
     gt;Source：@Source
     </
     Source
     >
     

                     
     <
     StackTrace
     >-&
     gt;Stack Trace：@StackTrace
     </
     StackTrace
     >
     

                     
     <
     TargetSite
     >-&
     gt;Trigger：@TargetSite
     </
     TargetSite
     >
     

                     
     <
     HResult
     >-&
     gt;Result Code：@HResult
     </
     HResult
     >
     

                     
     <
     EventDate
     >-&
     gt;Event Date：@EventDate
     </
     EventDate
     >
     

                     
     <
     OtherPlus
     >-&
     gt;Contact Method：
     </
     OtherPlus
     >
     

              
     </
     ILExceptionModel
     >
     

       
     </
     IsLine.ExceptionProcess.Configuration
     >
     


    
 
  

   
  

通过以上方式设置，异常抛出格式如下：

四．IsLine.Security 部分

这个部分可配置部分比较少，可以通过以下方式指定加密与解密时用到的种子：

   
    <
    add key
    =
    "
    IsLine.Security.Configuration.TokenKey
    "
     value
    =
    "
    IsLine
    "
    />

五．IsLine.HttpContent 部分

这个部分可以配置的有Cookie与邮件信息。

关于Cookie部分可配置信息如下：

Step 1.在<configSections>与</configSections>之间加入以下节点：

   
    <
    sectionGroup name
    =
    "
    IsLine.HttpContent.Configuration
    "
    >
    
    
    <
    section name
    =
    "
    Cookie
    "
     type
    =
    "
    IsLine.Data.Configuration.SuitConfig
    "
    />
    
  
    </
    sectionGroup
    >

Step 2.在<appSettings>前加入以下配置：

   
  
代码 
   
     <
     IsLine.HttpContent.Configuration
     >
     
    
     <
     Cookie
     >
     
      
     <
     Cryptography
     >
     False
     </
     Cryptography
     >
     
      
     <
     IsHttpOnly
     >
     True
     </
     IsHttpOnly
     >
     
      
     <
     IsSecure
     >
     False
     </
     IsSecure
     >
     
      
     <
     Domain
     >
     Default
     </
     Domain
     >
     


     </
     Cookie
     >
     
  
     </
     IsLine.HttpContent.Configuration
     >
     

    
 
  

   
  

参数	作用
Cryptography	表示是否启用Cookie的加密，它有True和Fasle两个值，如果值为True，在对Cookie进行新建或更新时，Provider将会自动进行加密，在读取Cookie时，Provider将会自动进行解密。该选项若为True，必须配合以下选项使用： <add key=" IsLine.Security.Configuration.TokenKey " value="IsLine"/> 该项默认为False。
IsHttpOnly	IsHttpOnly对应Cookie的HttpOnly属性，该属性指示是否只能在服务器端获取到用户Cookie。该项默认为False。
IsSecure	IsSecure对应Cookie的 Secure属性，如果该属性为True，那么cookie就只能通过https或其他安全协议才能传输，在http中是无效的。该项默认为False。
Domain	Domain 对应Cookie的Domain属性，该属性指明了Cookie的作用域。

邮件部分：

邮件模块可以实现对发送邮件功能的快速实现，并可以对SSL、编码、异步发送等选项进行设置。

Step 1.在<configSections>与</configSections>之间加入以下节点：

   
    <
    sectionGroup name
    =
    "
    IsLine.Message.Configuration
    "
    >
        
    //
    发邮件
    

            
    <
    section name
    =
    "
    SendMail
    "
     type
    =
    "
    IsLine.Data.Configuration.SuitConfig
    "
    />
    

    </
    sectionGroup
    >

Step 2.在<appSettings>前加入以下配置：

   
  
代码 
   
      
     <
     IsLine.Message.Configuration
     >
     

          
     <
     SendMail
     >
     

              
     <
     Sender
     ></
     Sender
     >
     

              
     <
     SenderPwd
     ></
     SenderPwd
     >
     

              
     <
     DisplayName
     >
     IsLineFrameWork
     </
     DisplayName
     >
      

              
     <
     MailFrom
     ></
     MailFrom
     >
      

              
     <
     SMTPAddr
     ></
     SMTPAddr
     >
     

              
     <
     SMTPPort
     >
     25
     </
     SMTPPort
     >
     

              
     <
     EnableSsl
     >
     False
     </
     EnableSsl
     >
      

              
     <
     MailEncode
     >
     UTF32
     </
     MailEncode
     >
      

              
     <
     IsBodyHtml
     >
     True
     </
     IsBodyHtml
     >
     

              
     <
     IsSendAsync
     >
     False
     </
     IsSendAsync
     >
     

          
     </
     SendMail
     >
     

    
     </
     IsLine.Message.Configuration
     >
     


    
 
  

   
  

参数	说明
Sender	用户名
SenderPwd	密码
DisplayName	显示的友好名称
MailFrom	显示的发件人
SMTPAddr	Smtp地址
SMTPPort	Smtp端口
EnableSsl	是否允许SSL验证
MailEncode	邮件标题与内容编码。支持以下枚举值：UTF8、 ASCII、 Default 、Unicode、 UTF32
IsBodyHtml	邮件内容是否支持HTML
IsSendAsync	是否采取异步发送