日本国产亚洲-日本国产一区-日本国产一区二区三区-日本韩国欧美一区-日本韩国欧美在线-日本韩国欧美在线观看

當(dāng)前位置:雨林木風(fēng)下載站 > 技術(shù)開發(fā)教程 > 詳細(xì)頁面

舊文重貼:在Csharp當(dāng)中運(yùn)用注釋(原創(chuàng))

舊文重貼:在Csharp當(dāng)中運(yùn)用注釋(原創(chuàng))

更新時(shí)間:2022-05-14 文章作者:未知 信息來源:網(wǎng)絡(luò) 閱讀次數(shù):

在Csharp當(dāng)中使用注釋


注意:本文是開心就好原創(chuàng),并且曾經(jīng)發(fā)表在《視窗世界》中,不歡迎轉(zhuǎn)貼,十分感謝!!!
由于軟件的復(fù)雜性以及不可預(yù)知性,所以在程序當(dāng)中添加注釋是一個(gè)非常明智的選擇,尤其是在團(tuán)隊(duì)開發(fā)當(dāng)中,可以使自己的程序更加適于閱讀。
我們知道Csharp(即C#)作為C++語言的一種擴(kuò)展版本,繼承了C++的注釋方法,即以“//”針對一行的注釋方法,或者以“/* */”跨行的注釋方法。可以很方便所有開發(fā)人員進(jìn)行使用。
例一

/*
Author:開心就好
Version:1.0
Date:: 2001/6/19
Description:構(gòu)建一個(gè)Test類
*/
public class test{
 //本類僅有一個(gè)公共方法
 public static void Main(){
 System.Console.WriteLine (“Hello,world”);//輸出Hello,World語句;
}
}
說明:在這段簡單的程序當(dāng)中,我們使用了兩種簡單的注釋方法,首先,我們知道“/**/”方法適合跨行注釋。一般來說,我們在一個(gè)程序體的首部都會使用這種方法對整個(gè)文件作一個(gè)簡單的描述。
而以//開始的注釋語句其有效范圍僅從該符號至該行末尾,//符號既可以放置在行首,亦可以在這一行的任意位置。
同時(shí),我們要注意,在可能的情況下請不要使用嵌套注釋語句,雖然有些編譯器可以自動處理這些嵌套的注釋語句,但作為一個(gè)良好的程序員,在其編程中應(yīng)該養(yǎng)成一個(gè)良好的習(xí)慣,盡量避免這種情況的發(fā)生。
例二:
/*
Author:開心就好
Version: 1.1
Date: 2001/6/19
Description:對Test類進(jìn)行合理的擴(kuò)展
*/
public class test{
 public static void Main(){
/*
//這是一個(gè)嵌套注釋,是一種不合理的狀態(tài)
*/
System.Console.WriteLine (“Hello,World”);
}

通過以上兩組例子,我們現(xiàn)在已經(jīng)對注釋有了基本的了解,但是如果僅是這些語句,可能就不根本不值得進(jìn)行這樣大篇幅的介紹,所以現(xiàn)在我們開始引入Csharp當(dāng)中專用的一種注釋方法――“///”,并且對這種注釋方法作詳細(xì)的介紹。
Csharp引用的這種注釋方法,原則上與原有的“//”相兼容,也是一種單行注釋方法,但由于其新增加了一些注釋語句,并且在VS.NET當(dāng)中進(jìn)行了相應(yīng)的集成,使其功能更加強(qiáng)大。
例三:
/*
Author:開心就好
Version:1.2
Date:2001/6/18
Description:構(gòu)建一個(gè)Test類
*/
///<Summary>一個(gè)Test類</Summary>
public class test{
 ///<Summary>入口方法</Summary>
 public static void Mial(){
System.Console.WriteLine(“Hello,World”);
 }
}
我們可以看看與前面的注釋有哪方面的不同。首先我們注意到增加了一個(gè)<Summary>的標(biāo)識符。但在這兒我們可能還沒有體會到它有什么具體的用處,相反,對于一些手寫代碼的朋友來說,我們可能還感覺到這樣去寫可能還增加了一些負(fù)擔(dān),因?yàn)橛忠嗲萌霂讉(gè)單詞。
且慢,下面我們開始對這個(gè)程序進(jìn)行編譯,我們知道,Csharp的編譯命令為CSC,如果大家對這個(gè)命令進(jìn)行過仔細(xì)的研究的話,我們可以看到它有一個(gè)參數(shù)為/doc,那這個(gè)參數(shù)有什么用呢?
下面,我們將例三的文件存為C:\test.cs,并且使用如下的命令行進(jìn)行編譯:
csc /t:exe /doc:test.xml test.cs
下面我們看一下C盤根目錄中,會出現(xiàn)一個(gè)新的XML文件,即test.xml,使用瀏覽器打開,其文件內(nèi)容為:
<?xml version="1.0" ?>
- <doc>
- <assembly>
<name>test</name>
</assembly>
- <members>
- <member name="T:test">
<Summary>一個(gè)Test類</Summary>
</member>
- <member name="M:test.Main">
<Summary>入口方法</Summary>
</member>
</members>
</doc>
到目前為止,我們可能仍然沒有看出來,這東西有什么用處。只不過多產(chǎn)生了一個(gè)XML文件而已。
如果在座的各位也有Java程序員,可能對此更是不屑一顧,因?yàn)樵贘ava編譯工具當(dāng)中,提供了JavaDoc文件,對Java程序當(dāng)中的注釋進(jìn)行整理,并且生成一個(gè)可讀的HTML文件,可以作為一個(gè)類的說明手冊。
其實(shí)CSC的DOC參數(shù)也是起類似的作用的,不過它只是生成了一個(gè)中間的XML數(shù)據(jù)文件。利用VS.NET提供的強(qiáng)大功能,這個(gè)XML數(shù)據(jù)文件會形成一個(gè)強(qiáng)大的說明文件,甚至在團(tuán)隊(duì)開發(fā)當(dāng)中,你只要寫清楚這些注釋語句就可以自動產(chǎn)生一個(gè)詳細(xì)設(shè)計(jì)文檔,而不必在寫完程序后自己再動手寫這么一份文檔。
在CSC的注釋語句中,除了<Summary>標(biāo)識符之外,微軟還提供了其它的標(biāo)識符,下面我們進(jìn)行逐一的介紹:

標(biāo)

溫馨提示:喜歡本站的話,請收藏一下本站!

本類教程下載

系統(tǒng)下載排行

主站蜘蛛池模板: 久久婷婷综合五月一区二区 | 亚洲 激情 | 欧美成人午夜毛片免费影院 | 国产精品一区二区免费福利视频 | 国产精品制服丝袜 | 人人爽天天爽夜夜爽曰 | 亚洲一区二区三区免费在线观看 | 国产成人在线网址 | 免费人成激情视频在线看 | 韩国毛片免费 | 日本高清免费在线视频 | 免费国产成人高清在线观看麻豆 | 成人嫩草研究院网站进 | 国产一区二区三区日韩欧美 | 亚洲精品一二区 | 俺来也俺来也天天夜夜视频 | 三级国产三级在线 | 久久精品国产在爱久久 | 亚洲综合日韩精品欧美综合区 | 精品精品国产自在香蕉网 | 欧美激情婷婷 | 亚洲欧美另类国产 | 色窝窝免费播放视频在线 | 狠狠综合久久综合88亚洲日本 | 日本肉肉视频免费观看 | 亚洲视频免费观看 | 中文精品久久久久国产网址 | 国产成人在线观看网站 | 久久久99精品免费观看精品 | 久久天天躁狠狠躁夜夜躁 | 青青草国产97免久久费观看 | 日韩中文字幕在线观看 | 韩国毛片在线观看 | 欧洲色吧| 桃色视频在线 | 日韩在线不卡一区在线观看 | 国产欧美成人免费观看 | 国产精品久久永久免费 | 国产网址在线观看 | 亚洲欧美精品天堂久久综合一区 | 黄色a级片免费看 |