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

    IsLine FrameWork一个是支持企业应用系统开发的框架，开发人员可以在其基础上对企业所需的应用系统进行快速开发，目前版本为V1.0版，随着需求的不断完善，IsLine FrameWork的版本也在不断升级。

    IsLine FrameWork完成了对数据源、服务器端变量、缓存、日志、异常、安全性能等元素的封装，支持多种数据库、多个数据库同时操作；支持跨方法的事物；支持多个日志渲染器同时工作，这意味着开发人员可以同时将分类日志信息写入不同的目标。该框架以配置文件为中心，所有变更动作(例如改变数据库、改变日志记录介质等)都可以通过修改配置文件完成，这一篇文章就为大家总结了IsLine FrameWork中所有用到的配置信息，大家可以当做字典使用，欢迎大家阅读。

    先来回顾一下IsLine FrameWork总体命名空间框架图：

 

  IsLine FrameWork配置项保存在web.config中，配置内容主要分布在以下三个节点中：

1. 位于<configSections></configSections>节点中的内容，主要以<sectionGroup></sectionGroup>标签体现
2. 位于<appSettings>之前的内容
3. 位于<appSettings></appSettings>之间的内容，主要以<add>标签体现

以上三部分不必同时出现，只需根据实际需要匹配出现。下面将按照命名空间顺序，给大家介绍相关配置项的信息。

  一．IsLine.Data命名空间

    这部分主要决定了所操作的数据库类型与位置，以及其他数据库方面的配置信息，有两种方式实现：

   方式一.

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

   

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

 

 

     Step 2.在</configSections>后加入：

        ·如果你希望使用SQL SERVER数据库(无版本限制)：

<IsLine.Data.Configuration>          <DataBaseConnection>                <DBType>IsLine.Data.DataTypeEnum.DataBaseType.SqlServer</DBType>                <Server>IP</Server>                <UserID>sa</UserID><PwdType>Cryptography.None</PwdType>                <Pwd>111111</Pwd>                <DataBase>UML</DataBase>  //SqlServer only          </DataBaseConnection>      </IsLine.Data.Configuration>

     · 如果你希望使用Oracle数据库：

 

<IsLine.Data.Configuration>          <DataBaseConnection>                <DBType>IsLine.Data.DataTypeEnum.DataBaseType.Oracle</DBType>                <Server>IP</Server>                <UserID>ID</UserID>                <PwdType>Cryptography.Decrypting</PwdType>                 <Pwd>111111</Pwd>                <OtherPlus>Provider=MSDAORA.1; Persist Security Info=False;</OtherPlus>             </DataBaseConnection>      </IsLine.Data.Configuration>

  节点含义：

参数

含义

DBType

指明了需要使用的数据库种类

Server

数据库地址

UserID

用户名

Pwd

密码

PwdType

密码加密类型，可以从以下表格中的枚举值中选取

DataBase

数据库名称(仅在DBType 为SQL SERVER时，该项有效)

OtherPlus

Oracle特征配置选项，可以为空（仅在DBType 为Oracle时，该项有效）

  PwdType参数支持的枚举：

枚举

含义

Cryptography.Decrypting

使用了IsLine.Security空间下的加密算法加密了密码。设置该枚举值后，Pwd须为IsLine.Security.Cryptography 空间下的static string Decrypting (string Source, string Key)方法加密后的值

Cryptography.StrengthDecrypting

使用了IsLine.Security空间下的强加密算法加密了密码。设置该枚举值后，Pwd须为IsLine.Security.Cryptography 空间下的static string StrengthDecrypting (string str,string key)方法加密后的值

Cryptography.None

密码不加密。设置该枚举值后，Pwd须为明文

    注意，如果你使用了密文方式配置密码，你必须使用以下方式指定加密时用到的种子：

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

    方式二. 使用<add>标签完成配置工作

      ·如果你希望使用Oracle数据库,则添加以下配置信息：

<add key="IsLine.Data.Configuration.OracleConnectString" value="Data Source=DS;User;Password=11111;Integrated Security=no;Enlist=false;Pooling=true;" />

    ·如果你希望使用SQL SERVER数据库,则添加以下配置信息：

<add key=" IsLine.Data.Configuration.SqlServerConnectString" value="Server=IP;User;Pwd=111111;DataBase=db;" />

    配置Oracle连接串时，Data Source含义为指定tnsnames文件中Oracle节点名称。

    以上两个方法(方式一与方式二)，可任选其一，如果两种方法同时存在，则方法一优先级高于方法二，方法一有效。如果希望同时使用多个数据库，可以利用<add>标签添加数据库信息，然后利用DataProvider中方法参数区分使用不同的连接串，具体请参见之前的文章。

  二．IsLine.AppLog日志部分

    目前日志模块支持将日志写入文件、sql语句形式写入SQL数据库、存储过程形式写入SQL数据库、sql语句形式写入Oracle数据库、存储过程形式写入Oracle数据库以及邮件通知，以下列出所有已经内置支持的配置方式，各位可以根据实际情况进行增减：

    Step 1.如果你需要将日志写入数据库，需要做一些先导工作，例如建立表、触发器等。

       如果是Oracle数据库，请通过以下步骤完成先导工作：

        a.使用以下附件建表

           http://files.cnblogs.com/isline/ILFW日志模块建表.rar

        b. 使用以下附件建立序列

           http://files.cnblogs.com/isline/ILFW日志模块序列.rar

        c. 使用以下附件建触发器：

           http://files.cnblogs.com/isline/ILFW日志模块触发器.rar

        d.如果希望使用sql语句记录日志，那么请在step 3中，保持“OracleUsingTextRender”节点默认值即可，该节点中已经对sql语句有所配置。

        e.如果希望使用存储过程记录日志，使用以下附件建立存储过程

           http://files.cnblogs.com/isline/ILFW日志模块存储过程.rar

       如果是SQL SERVER数据库，请通过以下步骤完成先导工作：

        a.使用以下附件建表

           http://files.cnblogs.com/isline/ILFW日志模块建SQL表.rar

        b.如果希望使用sql语句记录日志，那么请在step 3中，保持“SQLServerUsingTextRender”节点默认值即可，该节点中已经对sql语句有所配置。

        c.如果希望使用存储过程记录日志，使用以下附件建立存储过程

          http://files.cnblogs.com/isline/ILFW日志模块建SQL存储过程.rar

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

<sectionGroup name="IsLine.AppLog.Configuration"><section name="FileRender" type="IsLine.Data.Configuration.SuitConfig"/><section name="OracleUsingSPRender" type="IsLine.Data.Configuration.SuitConfig"/><section name="OracleUsingTextRender" type="IsLine.Data.Configuration.SuitConfig"/><section name="SQLServerUsingSPRender" type="IsLine.Data.Configuration.SuitConfig"/><section name="SQLServerUsingTextRender" type="IsLine.Data.Configuration.SuitConfig"/><section name="MailRender" type="IsLine.Data.Configuration.SuitConfig"/></sectionGroup>

       参数说明：

参数

说明

FileRender

将日志记录至文本文件

OracleUsingSPRender

使用存储过程，将日志记录至Oracle

OracleUsingTextRender

使用sql语句，将日志记录至Oracle

SQLServerUsingSPRender

使用存储过程，将日志记录至SQL Server

SQLServerUsingTextRender

使用sql语句，将日志记录至SQL Server

MailRender

将日志发送邮件至收件人

       以上参数节点可根据需要保留，将不需要的节点删除即可，注意，节点名称和数量要与Step 3中的一一对应。当然，你也可以自定义日志渲染节点，将日志信息输出至电视机，详细方法见《ASP .NET企业开发框架IsLine FrameWork系列》文章。