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	是否采取异步发送