Step by step:一起来学C# (3)

前言:前两天肥老家啦,本来想着要休息几天,啥事儿不干混吃混喝等开学,奈何家里有个贤内助,鼓励我写文章,说指着我的文章入门.net,嘎嘎嘎。虽然至今为止貌似也没啥童鞋来围观,但是坚持就是胜利嘛。

相信大家看到过不少别人写的程序,有的程序注释很好,程序文档组织很清晰,程序的说明也很详细明了,大大提高了程序的可复用、可维护性;有的程序则让人一看就决定自己重写算了,这就是程序规范的重要性。

今天这篇文章主要说说我们组使用的一个C#工程框架,感觉还是比较清晰明了的。我们老师每天跟我们强调文档的规范、程序注释的规范,想出来好几套(包括MCU微控制器程序框架、C#工程框架、Web工程框架等)清晰的工程文件的组织方式(即工程框架),细节到文档的命名。我们使用了3-4年,觉得还是很不错的,后期维护和修改挺方便。今天这篇文章说的就是我们老师安利给我们的C#工程框架,遵照这个框架来安排程序,会比较有条理哟。

提纲:给出一个比较清晰明了的C#工程框架,及自定义修改工程框架的方法。


嘎嘎嘎

一、C#工程框架

为了有序更好的学习C#,并且在后期的实际项目中,代码组织更清晰合理,非常有必要搭建一个好的工程框架。下表是推荐的一个C#工程框架:


工程框架文件组织


按照工程框架组织程序及文档

二、按照框架从头组织一个程序

我们使用上一篇文章给出的Hello World程序开始,按照给出的C#工程框架,重新组织一下文档和程序。下图就是组织之前的工程:

Hello World程序

1.新建工程文件夹

(1)在项目工程名上右击->添加->新建文件夹

新建文件夹

(2)在新建的文件夹上右击->重命名,修改成表格中给出的名字,如“01-Doc”。

文件夹重命名1
文件夹重命名2

按照这种方法,创建如图的6个文件夹:

创建文件夹

PS:为啥给文件夹编号呢?-编号之后,文件夹的顺序就定下来啦,打开程序所在文件夹,看到的也是一样的顺序。

2.将相应的程序文件移动到相应文件夹

工程框架在第一步就算是建好了,下面我们要将相应的文件,放到对应的文件夹中。

(1)在要移动的程序或文件上右击->剪切;在目标文件夹上右击->粘贴。这样,工程中的文件就移动到相应的文件夹下面啦。比如Form,是窗口文件,就移动到02-Form,即窗体文件夹之中。

文件移动1
文件移动2
文件移动3

文件移动完成之后,就如上图。目前工程非常简单,没有很多使用到的类库、只有一个窗体、没有数据库、工程图片、用户自定义控件等。到后期,工程复杂起来就可以看到使用这个工程框架的好处。看别人的程序,或者后期修改,一般是先看说明文件,就在01-Doc中。C#工程最直观的是窗体,双击即可进入响应程序,放在了工程第二位,有多个窗体的时候,不用在杂乱的程序文件中扫描,直接在02-Form中找,其他文件亦然。要注意的是,后期文件按照文章开头的表格组织文件,对应摆放。

3.在文件夹中添加文件

我们常常需要在建好的工程框架中新建、添加文件。

(1)添加已有文件;例如在工程中添加一个程序说明文档readme.docx.程序说明文档将会放在01-Doc中。我们在工程目录下01-Doc文件夹中,新建一个readme.docx:

新建文件

新建完之后,在VS程序框架中还是看不见这个文件的,需要如下操作:

在目标文件夹上右击->添加->现有项

添加文件1

默认只能看见C#类型文件,需要改成所有文件,如下图:

添加文件2

选中要添加的文件,点击添加:

添加文件3

(2)在工程下新建一个程序文件,以添加一个类文件为例:

在目标文件上右击->添加->类:

添加程序文件1

选择要添加的文件类型,此处添加一个类:选中类->修改文件名称->点击添加:

添加程序文件2

添加之后,会自动填写好此类型文件的相关代码如下:(这个类后期是作为全局变量声明的地方)

添加程序文件3

4.添加完成的工程框架

编辑完成之后的工程框架如下图:

工程框架

后期我们添加窗体、类等程序或文件时,应当遵守文章开头给出的表格,将相应的程序放到相应的位置,方便后续的阅读、修改。

5.readme文档的写法

程序说明文档对于看程序的人来说,非常重要。要想别人更好的理解你写的程序,使用你的程序,我们就应当好好重视这一块内容的书写;下图是一个推荐的程序说明文档的结构示意。后续给出的实验程序,均可到01-Doc文件夹中查看程序说明文档。

程序说明文档

希望大家都能写出功能强大,而又规范易懂的程序,造福社会。少一些看不懂、难重用的垃圾程序,多一些可读性强、高可复用、可移植的优质程序,一起加油啦!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,542评论 6 504
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,822评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,912评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,449评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,500评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,370评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,193评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,074评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,505评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,722评论 3 335
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,841评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,569评论 5 345
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,168评论 3 328
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,783评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,918评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,962评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,781评论 2 354

推荐阅读更多精彩内容