Previous topicNext topic
Help > 开发指南 >
前言

给所有初学者

从这一章开始我们要正式进入森之格低代码平台的代码开发阶段。能够看到这里,相信您基本已经了解了我们平台中即使不写代码也可以做成什么样的系统。下面,就请您跟随我的步伐一起进入代码编写的篇章。

因为本平台所面对的客户群体既包含不懂编程只懂业务流程的业务高手,也包含一些专业的程序员。所以本平台集成了VB.Net和C#两种语言。VB.Net适合非专业编程人员快速学习使用,入门相对容易一些。C#适合专业的程序员不用花费多余的学习成本直接上手使用本平台。我们是一个低代码平台,虽然通过配置可以完成大部分常规的基于表和绑定控件场景的系统开发。但是,一个成熟的系统是复杂的,每个公司的需求也是千变万化的,只有能够满足所有客户的开发需求,这样的平台才算作是一个合格的低代码开发平台。所以,我们这里提供了完善的开发功能。既然我们已经看到开发指南了,那么就必然会涉及到代码的编写。为了照顾一下不太精通代码编写的初学者,我们的教程写作可能会偏浅显一点,已经有编程基础的人员在看本帮助文档时,只需要挑一些本平台特有的部分学习即可。

关于帮助文档的示例语言,为了照顾所有人,我们在编写帮助文档时,尽量提供VB.net和C#两种代码的示例。如果部分简单的代码可能不需要分开展示的话,就会以VB.net为主。因为同时提供两种语言的代码示例,这个工作量会提升很多,很多时候我们采用的是直接用VB.Net语言写Demo,然后测试OK后再通过网络上的Vb.Net转C#的工具直接将代码转换过来,然后再人工修改一下明显的错误代码。这就会导致部分C#示例代码可能会有意想不到的小BUG。那么我们为什么不采用先写C#代码再通过C#代码转换成Vb.Net的方式呢?因为目前找到的代码转换工具只有Vb.Net转C#是可以将注释内容一起转换的,而C#转VB.Net会忽略掉注释内容,这样会大大增加代码转换的工作。

为了让大家平时写代码时,可以更顺滑、方便,我们采用了非常优秀的代码编辑器,可以非常智能提示所有对象的方法、属性,还能提示相应的注释内容。有时候我们忘记了某个对象的属性名称,或者单纯地想详细地了解一个对象里面有多少可以使用的属性、方法,我们可以使用代码编辑器右键中“显示定义”功能来打开一个新的窗体显示这个对象中所有公开的属性和方法。里面包含所有的注释,方法我们查找、学习。

习惯约定

1、Proj.MsgDebug使用。本章在写代码示例的时候,为了将运行或计算的结果显示到命令窗口,一般都会采用Proj.MsgDebug.Add来显示。为什么采用这个,可以参考“MsgDebug”和“代码调试”。见到类似的代码时,可以考虑直接复制代码到命令窗口中去执行,然后看看执行结果,方便自己在学习的过程中加深理解。

 Vb.Net
Dim dateString As String="20220706132536"
Dim dt As DateTime=DateTime.ParseExact(dateString, "yyyyMMddHHmmss", System.Globalization.CultureInfo.CurrentCulture)
Proj.MsgDebug.Add(dt)  '转换结果:2022-07-06 13:25:36

 C#

string dateString ="20220706132536";
DateTime dt = DateTime.ParseExact(dateString,"yyyyMMddHHmmss", System.Globalization.CultureInfo.CurrentCulture);
Proj.MsgDebug.Add(dt);// 转换结果:2022-07-06 13:25:36

2、SmGrid对象的引用。后续的帮助文档中很多时候会直接Dim tbl as SmGrid=Proj.CurrentSmGrid来直接获得一个SmGrid表对象。帮助文档只是为了方便获得一个表对象。请大家根据自己写代码的位置使用合适的方式引用表对象。具体如何合适地引用表对象,可以参考“如何引用表”。