当前位置:编程学习 > C#/ASP.NET >>

谁帮我写上更详细的注释啊?最好每行都写 555~~

这个是一个文本编辑器,关闭窗口之前所发生的事件,我看不甚懂,希望懂的帮帮下……
我想懂的应该都知道定义的变量是什么意思吧?!比如“下划线Modifide”我就不先解释了……嘿嘿

        private bool AskSave( )
        {
            //如果已经修改了当前文件,则询问是否保存
            if (this._Modified)
            {
                switch (MessageBox.Show("文件已修改, 是否保存?", "提示",
                    MessageBoxButtons.YesNoCancel, MessageBoxIcon.Question,
                    MessageBoxDefaultButton.Button1))
                {
                    case DialogResult.Yes:  //需要保存,则保存,然后返回true
                        if (string.IsNullOrEmpty(this._FileName))
                        {
                            SaveFileDialog sfdlg = new SaveFileDialog( );
                            sfdlg.Filter = "文本文件(*.txt)|*.TXT";
                            sfdlg.FileName = this._FileName;
                            if (sfdlg.ShowDialog( ) == DialogResult.OK)
                            {
                                this._FileName = sfdlg.FileName;
                            }
                            else //没有选择文件,退出
                            {
                                return true;
                            }  
                        }
                        //保存到新文件
                        this.SaveFile( );
                        return true;
                    case DialogResult.Cancel: //取消操作,返回false
                        return false;
                    case DialogResult.No:   //不保存,则返回true
                        return true;
                }
            }
            //文件没有修改,继续操作
            return true;
        }


这个是那个事件

        private void FrmEditor_FormClosing(object sender, FormClosingEventArgs e)
        {
            //窗体关闭之前确认,如果放弃关闭,则取消关闭
            if (!this.AskSave( ))
            {
                e.Cancel = true;
                return;
            }
        }

--------------------编程问答-------------------- 注释已经太多了,注释越多越容易低能啊! --------------------编程问答--------------------        private void FrmEditor_FormClosing(object sender, FormClosingEventArgs e)
        {
            //窗体关闭之前确认,如果放弃关闭,则取消关闭
            if (!this.AskSave( ))
            {
                e.Cancel = true;
                return;
            }
        }
关闭前问 是否保存等。。 看返回是什么 进行 保存, 直接关闭 取消继续操作  --------------------编程问答--------------------       private bool AskSave( )
        {
            //如果已经修改了当前文件,则询问是否保存
            if (this._Modified)  //进行修改
            {
                switch (MessageBox.Show("文件已修改, 是否保存?", "提示",
                    MessageBoxButtons.YesNoCancel, MessageBoxIcon.Question, //是否取消
                    MessageBoxDefaultButton.Button1))
                {
                    case DialogResult.Yes:  //需要保存,则保存,然后返回true
                        if (string.IsNullOrEmpty(this._FileName))
                        {
                            SaveFileDialog sfdlg = new SaveFileDialog( );//保存
                            sfdlg.Filter = "文本文件(*.txt)|*.TXT";
                            sfdlg.FileName = this._FileName;
                            if (sfdlg.ShowDialog( ) == DialogResult.OK)
                            {
                                this._FileName = sfdlg.FileName;
                            }
                            else //没有选择文件,退出
                            {
                                return true;     
                            }  
                        }
                        //保存到新文件
                        this.SaveFile( );
                        return true;
                    case DialogResult.Cancel: //取消操作,返回false
                        return false;
                    case DialogResult.No:   //不保存,则返回true
                        return true;
                }
            }
            //文件没有修改,继续操作
            return true;
        } --------------------编程问答-------------------- 这个真不需要太多
只要把方法名说下功能,顶多变量、参数说明下就OK --------------------编程问答-------------------- 如果你认为某个东西你不理解,就删除它(注释掉它),然后你去按照系统应有的功能来测试。如果测试通过,这就说明你删除的代码确实该删,它是心血来潮的东西。如果测试出现bug,你就自己定义实现逻辑代码来看看效果.........这样,你就自己掌握了读代码的能力!

写注释?大多数人强调的都是无能的做法。 --------------------编程问答-------------------- 楼上大哥一针见血啊 --------------------编程问答--------------------
引用 5 楼 sp1234 的回复:
如果你认为某个东西你不理解,就删除它(注释掉它),然后你去按照系统应有的功能来测试。如果测试通过,这就说明你删除的代码确实该删,它是心血来潮的东西。如果测试出现bug,你就自己定义实现逻辑代码来看看效果.........这样,你就自己掌握了读代码的能力!

写注释?大多数人强调的都是无能的做法。

有道理。。。 --------------------编程问答-------------------- 不要觉得我重复了两遍一个比较刺眼的字眼。其实读代码的能力真是很基本的,如果不容易读,最好的办法就是删除它然后你自己写!

这样,你就习惯于首先去理解程序的目标、创意、条件、框架、编写者的风格水平等等,这样就能自然而然地获得读代码的能力。好的团队总是一帮有勇气的人在一起,而不是一帮指望别人给写多么“详细的”注释的人在一起的。 --------------------编程问答-------------------- 每天回帖即可获得10分可用分! --------------------编程问答-------------------- 这注释已经太清楚了 --------------------编程问答-------------------- 不是,大家为什么都批斗俺呢???
俺这是看 别人的程序,看不懂什么意思撒,想让大家告诉俺那些方法写的格式都是什么意思,俺从头到尾都是自学,也没个老师教,发个小贴也批斗俺……
我说我容易么?上辈子欠你的…………
ok,是不是我要MSDN看方法? --------------------编程问答-------------------- 不是,大家为什么都批斗俺呢???
俺这是看 别人的程序,看不懂什么意思撒,想让大家告诉俺那些方法写的格式都是什么意思,俺从头到尾都是自学,也没个老师教,发个小贴也批斗俺……
我说我容易么?上辈子欠你的…………
ok,是不是我要MSDN看方法? 
  --------------------编程问答-------------------- SaveFileDialog 提示用户选择文件的保存位置
DialogResult 枚举
指定标识符以指示对话框的返回值。
看看MSDN
--------------------编程问答--------------------
这注释很清楚了,要加的确不知道怎么加。
大体翻译下,按这个思路看看应该很容易懂

1、当我们点击关闭按钮时,弹出3个选择按钮提示“是否保存”,分别是“是”、“否”、“取消”
2、点击“是”的时候,我们做保存操作,然后关闭窗体
3、点击“否”的时候,我们什么都不做,然后关闭窗体
4、点击“取消”的时候,我们啥都不做,也不关闭窗体 --------------------编程问答--------------------
引用 8 楼 sp1234 的回复:
不要觉得我重复了两遍一个比较刺眼的字眼。其实读代码的能力真是很基本的,如果不容易读,最好的办法就是删除它然后你自己写!

这样,你就习惯于首先去理解程序的目标、创意、条件、框架、编写者的风格水平等等,这样就能自然而然地获得读代码的能力。好的团队总是一帮有勇气的人在一起,而不是一帮指望别人给写多么“详细的”注释的人在一起的。

sp1234说的是很有道理的,不要说批斗不批斗,你可以指望别人提醒你12,但指望不了别人一句一句教你怎么做 --------------------编程问答-------------------- 就这里还不明白
                           sfdlg.FileName = this._FileName;
                            if (sfdlg.ShowDialog( ) == DialogResult.OK)
                            {
                                this._FileName = sfdlg.FileName;
                            }


sfdlg.FileName = this._FileName;//这条是不是要不要都行????????


sfdlg.ShowDialog( ) == DialogResult.OK//它的意思是不是当按了保存键后,把输入的名字赋给原文本啊???    简单解释下,ShowDialog呗? --------------------编程问答--------------------
引用 1 楼 sp1234 的回复:
注释已经太多了,注释越多越容易低能啊!


太幽默了。呵呵。大实话。
这么多注视了还嫌少,哪看不懂的,查msdn吧。 --------------------编程问答-------------------- 注释不少了 --------------------编程问答-------------------- 都看完了....    
我觉得 我得出来说两句   多写注释 并不是什么低能的做法  而是养成一种良好的习惯。
就拿LZ 这段代码来说吧 假如以句注释也没有,当然写这代码的人肯定没问题  但是有没有想过 你写完之后
如果不是你来维护的话 而是别人 ,那么那个接手你代码的人 会感到很痛苦 一大堆的代码 一个注释也没有
维护肯定是能维护的 但是相比有注释来说 肯定会吃力很多,(我这是实话)
  我一直任务写代码 要养成一种良好的习惯 这里面什么都包括  。
          上次去一家公司面试  聊到最后叫我去看一下他们写的代码质量如何  他把程序一打开  一大推的代码 一个注释都没有 我一眼就看到不满意了,直接和他说了 第一眼让人感觉 写这代码的人  习惯不怎么好
   特别是数据传递带参  带了一堆的参数  而且没有一个注释   你这叫别人 怎么认你的代码
就算你是再牛的人 也不希望看到这些代码吧  起码不愿意去苦读别人写的代码.


好了就讲到这 ........... --------------------编程问答-------------------- 该有的地方是该加,不过lz还是得自己仔细琢磨程序才是。。。
补充:.NET技术 ,  C#
CopyRight © 2012 站长网 编程知识问答 www.zzzyk.com All Rights Reserved
部份技术文章来自网络,