HOW TO：在 Visual C# .NET 中创建自定义 ASP.NET 配置节处理程序

创建配置节处理程序及其组件

<script type="text/javascript"></script> 以下步骤演示如何创建配置节处理程序及其组件。为了使您可以更好地维护并重用这些代码，以下步骤演示了如何创建一个包含静态方法的名为 ConfigHelper 的类。这些静态方法帮助您分析并检索配置文件中的 XML 属性。由于构建 ConfigHelper 的代码在配置节中使用枚举和一个字符串，所以 ConfigHelper 包含两种方法：GetEnumValue 和 GetStringValue。

GetEnumValue 方法用预定义的值分析配置节中的属性，确认属性值有效，然后返回该属性及属性值。GetStringValue 方法分析配置节中的属性，然后返回属性及属性值。

1. 启动 Microsoft Visual Studio .NET。
2. 在文件菜单上，指向新建，然后单击项目。
3. 在新建项目对话框中，单击项目类型下的 Visual C# Projects，然后单击模板下的类库。在名称文本框中，键入 MyConfig，然后单击确定。
4. 添加一个对 System.Web.dll 程序集的引用。
5. 将 Class1.cs 重命名为 MyConfig.cs。
6. 从"解决方案资源管理器"中，打开 MyConfig.cs。
7. 将以下名称空间声明添加到文件的顶部：

   using System.Configuration;
   using System.Web;
   using System.Xml;

8. 删除默认类定义。
9. 添加枚举以保存自定义配置节的属性：

   public enum LevelSetting
   {
   High,
   Medium,
   Low,
   None
   }

10. 创建名为 MyConfigSection 的类来保存配置信息。该类是 Create 方法实现返回的对象。

    public class MyConfigSection
    {
    private LevelSetting level = LevelSetting.None;
    private string name = "";
    public MyConfigSection(LevelSetting _level, string _name)
       {
    level = _level;
    name = _name;
       }
    public LevelSetting Level
       {
    get {return level;}
       }
    public string Name
       {
    get {return name;}
       }
    }

11. 按如下所示创建名为 ConfigHelper 的类：

    internal class ConfigHelper
    {
    //Helper method for retrieving enum values from XmlNode.
    public static XmlNode GetEnumValue
    (XmlNode _node, string _attribute,Type _enumType, ref int _val)
       {
    XmlNode a = _node.Attributes.RemoveNamedItem(_attribute);
    if(a==null)
    throw new ConfigurationException("Attribute required:" + _attribute);
    if(Enum.IsDefined(_enumType, a.Value))
    _val = (int)Enum.Parse(_enumType,a.Value);
    else
    throw new ConfigurationException("Invalid Level:'" + a.Value + "'",a);
    return a;
       }
    //Helper method for retrieving string values from xmlnode.
    public static XmlNode GetStringValue(XmlNode _node, string _attribute, ref string _val)
       {
    XmlNode a = _node.Attributes.RemoveNamedItem(_attribute);
    if(a==null)
    throw new ConfigurationException("Attribute required:" + _attribute);
    else
    _val = a.Value;
    return a;		
       }
    }

    备注：您也可以为每一种数据类型创建一个 helper 方法用于您的配置节（例如，GetIntValue 和 GetBooleanValue）。
12. 创建一个名为 MyConfigSectionHandler 的类。该类继承 IConfigurationSectionHandler 接口并实现该接口的 Create 方法。在 Create 方法中，此代码使用 ConfigHelper 类从配置文件检索数值。然后，该示例创建并返回 MyConfigSection 对象。
    
    MyConfigSectionHandler 类应如以下所示：

    public class MyConfigSectionHandler :IConfigurationSectionHandler
    {
    public virtual object Create(object parent,object configContext,XmlNode section)
       {
    int iLevel = 0;
    string sName = "";
    
    ConfigHelper.GetEnumValue(section, "level", typeof(LevelSetting), ref iLevel);
    ConfigHelper.GetStringValue(section, "name", ref sName);
    return new MyConfigSection((LevelSetting)iLevel,sName);
       }
    }

13. 保存并编译项目。

完整代码列表

using System; using System.Xml; using System.Configuration; namespace MyConfig { public enum LevelSetting { High, Medium, Low, None } public class MyConfigSectionHandler : IConfigurationSectionHandler { public virtual object Create(object parent, object configContext, XmlNode section) { int iLevel = 0; string sName = ""; ConfigHelper.GetEnumValue(section, "level", typeof(LevelSetting), ref iLevel); ConfigHelper.GetStringValue(section, "name", ref sName); return new MyConfigSection((LevelSetting)iLevel, sName); } } public class MyConfigSection { private LevelSetting level = LevelSetting.None; private string name = null; public MyConfigSection(LevelSetting _level, string _name) { level = _level; name = _name; } public LevelSetting Level { get { return level; } } public string Name { get { return name; } } } internal class ConfigHelper { public static XmlNode GetEnumValue (XmlNode _node, string _attribute, Type _enumType, ref int _val) { XmlNode a = _node.Attributes.RemoveNamedItem(_attribute); if (a == null) throw new ConfigurationException("Attribute required:" + _attribute); if (Enum.IsDefined(_enumType, a.Value)) _val = (int)Enum.Parse(_enumType, a.Value); else throw new ConfigurationException("Invalid Level", a); return a; } public static XmlNode GetStringValue(XmlNode _node, string _attribute, ref string _val) { XmlNode a = _node.Attributes.RemoveNamedItem(_attribute); if (a == null) throw new ConfigurationException("Attribute required:" + _attribute); else _val = a.Value; return a; } } }

<script type="text/javascript"></script> 在最后一个窗体中，您的类文件应如以下所示：

测试配置处理程序

<script type="text/javascript"></script>

1. 打开 Visual Studio .NET。
2. 在新建项目对话框中，单击项目类型下面的 Visual C# 项目，然后单击模板下面的 ASP.NET Web 应用程序。为您的新项目指定名称和位置。
3. 添加对 MyConfig.dll 的引用。
4. 打开 Web.config 文件。在 <configuration> 部分添加以下代码：

   <configSections>
   <sectionGroup name="system.web">
   <section name="myConfig" type="MyConfig.MyConfigSectionHandler,MyConfig" />
   </sectionGroup>
   </configSections>

5. 在 <system.web> 部分添加以下代码：

   <myConfig level="High" name="hello world" />

6. 打开 WebForm1.aspx 的代码隐藏 (code-behind) 文件，默认名为 WebForm1.aspx.cs。在 WebForm1.aspx.cs 顶部添加以下名称空间声明：

   using MyConfig;

7. 将下面的代码添加到 Page_Load 事件：该代码调用 GetConfig 方法来检索 MyConfigSection 对象的实例，然后填写该对象的两个属性值。

   MyConfigSection s = (MyConfigSection)Context.GetConfig("system.web/myConfig");
   Response.Write("Level:" + s.Level + "<br>");
   Response.Write("Name:" + s.Name);

8. 保存并编译该应用程序。
9. 在浏览器中查看该页面。输出如下：
   Level:High
   Name:hello world

 

 

http://support.microsoft.com/kb/309045/zh-cn