C#方便的生成函数字典

原创 2012年03月29日 14:03:01

C#方便的生成函数字典

下面介绍一个方式能够很快的生成对C#函数的注释转成XML文档,这样能够减少很多的函数说明文档的撰写时间,直接进去主题:

有个解决方案下有个XmlHelper.cs 对于XML的通用操作类,下面是部分代码:

 


/*************************************************************************************
* 代码:吴蒋
* 时间:2012.03.07
* 说明:XML操作类
* 其他:
* 修改人:
* 修改时间:
* 修改说明:
************************************************************************************/
#region 引用空间
using System;
using System.Collections;
using System.Xml;
using System.Data;
using System.IO;
using System.Text;
using System.Collections.Generic;
#endregion

namespace Tools
{
    #region XML操作类
    /// <summary>
    /// XML操作类
    /// </summary>
    public class XmlHelper
    {
        #region 构造函数
        /// <summary>
        /// 单例
        /// </summary>
        /// <returns>XmlHelper</returns>
        public static XmlHelper Instance()
        {
            return new XmlHelper();
        }
        #endregion

        #region 公共变量
        /// <summary>
        /// XML文档对象
        /// </summary>
        XmlDocument xmlDoc;
        /// <summary>
        /// XML文档节点
        /// </summary>
        XmlNode xmlNode;
        /// <summary>
        /// XML文档元素
        /// </summary>
        XmlElement xmlElem;
        /// <summary>
        /// XML节点列表
        /// </summary>
        XmlNodeList xmlNodeList;
        #endregion

        #region 分页获取主题配置Jason
        /// <summary>
        /// 分页获取主题配置Jason
        /// </summary>
        /// <param name="allCount">返回主题总数</param>
        /// <param name="pageCount">返回主题页数</param>
        /// <param name="pageSize">一页数量</param>
        /// <param name="absolutePage">当前页</param>
        /// <param name="filePath">配置文件路径</param>
        /// <param name="docPath">节点路径</param>
        /// <param name="atrList">属性列表</param>
        /// <returns>返回Jason格式主题数据</returns>
        public string SelectConfigListJason(out int allCount, out int pageCount, int pageSize, int absolutePage, string filePath, string docPath, List<string> atrList)
        {
            xmlDoc = new XmlDocument();
            xmlDoc = this.Read(filePath);
            xmlNodeList = xmlDoc.SelectNodes(docPath);

            allCount = xmlNodeList.Count;
            if (allCount % pageSize > 0)
            {
                pageCount = allCount / pageSize + 1;
            }
            else
            {
                pageCount = allCount / pageSize;
            }

            int start = pageSize * (absolutePage - 1);
            int end = start + pageSize - 1;
            if (allCount > 0)
            {
                StringBuilder sb = new StringBuilder();

                XmlNode xmlNode = null;
                for (int i = start; i <= end; i++)
                {
                    xmlNode = xmlNodeList.Item(i);
                    sb.Append("{");
                    for (int a = 0; a < atrList.Count; a++)
                    {
                        if (atrList.Count - 1 == a)
                        {
                            sb.Append("\"" + atrList[a] + "\":" + "\"" + xmlNode.Attributes[atrList[a]].InnerText + "\"");
                        }
                        else
                        {
                            sb.Append("\"" + atrList[a] + "\":" + "\"" + xmlNode.Attributes[atrList[a]].InnerText + "\",");
                        }
                    }

                    if (i == end)
                    {
                        sb.Append("}");
                    }
                    else
                    {
                        sb.Append("},");
                    }
                }
                return sb.ToString();
            }
            else
            {
                return "";
            }
        }
        #endregion

}


 

如果全部代码放出,会发现函数非常多,如果撰写函数说明文档会非常的费时间。所以我们让它们自动生成。

步骤1:点击开始->Microsoft Visual Studio 2008->Visual Studio Tools->Visual Studio 2008 命令提示

步骤2: 输入 csc /t:library /doc:想要输出的名字 cs文件路径  csc /t:library /doc:xmlHelp.xml C:\Users\Sunnes001\Desktop\生成函数字典\生成函数字典\生成函数字典\xmlHelp.cs

步骤3: 回车完成 然后在路径为C:\Program Files\Microsoft Visual Studio 9.0\VC 下就能找到生成的XML可以用浏览器直接打开。

 


 

 

C#常用函数列表,方便查找

  • 2010年12月28日 14:04
  • 12KB
  • 下载

C#时间格式化(Datetime)用法详解,方便生成所需求的时间格式

C#时间格式化Datetime.ToString参数format格式详细用法,本文将进行介绍,感兴趣的朋友可以了解下. Datetime.ToString(String, IFormatPr...

数据字典生成工具源码 (c#)

  • 2012年06月01日 14:18
  • 53KB
  • 下载

C# 生成数据字典(Word 表格)

先看一张效果图: 如果您觉得您会了,请绕道... 说说怎么实现的 第一步:添加引用 Microsoft.Office.Interop.Word 第二步:说说精髓部分,并非完整代码,末尾 附上 源码 ...

方便实用的电子版新华字典

  • 2008年09月10日 01:49
  • 11.24MB
  • 下载

c#(winform)中自定义ListItem类方便ComboBox和ListBox添加项完全解决(DropDownList 和Combox 数据绑定的常用方法)

刚开始用.net 的winform开发,发现好些控件都很难用,可能是不熟悉的原因吧,这不,一个给ComboBox添加项的问题就搞的我很头疼,我要同时给一个项添加名字和值,怎么都没法加,查了查资料,又自...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:C#方便的生成函数字典
举报原因:
原因补充:

(最多只允许输入30个字)