100162749.htm
来自「C#高级编程(第三版),顶死你们。。 。up」· HTM 代码 · 共 284 行 · 第 1/3 页
HTM
284 行
<p class="a4" style="MARGIN-LEFT: 10.7pt"><span style="FONT-FAMILY: 宋体">提供描述中的“参见”部分</span><span lang="EN-US">(</span><span style="FONT-FAMILY: 宋体">编译器要验证其语法</span><span lang="EN-US">)</span></p>
</td>
</tr>
<tr>
<td style="BORDER-RIGHT: windowtext 1pt solid; PADDING-RIGHT: 9.9pt; BORDER-TOP: medium none; PADDING-LEFT: 9.9pt; PADDING-BOTTOM: 1.4pt; BORDER-LEFT: medium none; WIDTH: 3cm; PADDING-TOP: 1.4pt; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="113">
<p class="a4" style="MARGIN-LEFT: 10.7pt"><span lang="EN-US"><summary></span></p>
</td>
<td style="BORDER-RIGHT: medium none; PADDING-RIGHT: 9.9pt; BORDER-TOP: medium none; PADDING-LEFT: 9.9pt; PADDING-BOTTOM: 1.4pt; BORDER-LEFT: medium none; WIDTH: 351.6pt; PADDING-TOP: 1.4pt; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="469">
<p class="a4" style="MARGIN-LEFT: 10.7pt"><span style="FONT-FAMILY: 宋体">提供类型或成员的简短小结</span></p>
</td>
</tr>
<tr>
<td style="BORDER-RIGHT: windowtext 1pt solid; PADDING-RIGHT: 9.9pt; BORDER-TOP: medium none; PADDING-LEFT: 9.9pt; PADDING-BOTTOM: 1.4pt; BORDER-LEFT: medium none; WIDTH: 3cm; PADDING-TOP: 1.4pt; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="113">
<p class="a4" style="MARGIN-LEFT: 10.7pt"><span lang="EN-US"><value></span></p>
</td>
<td style="BORDER-RIGHT: medium none; PADDING-RIGHT: 9.9pt; BORDER-TOP: medium none; PADDING-LEFT: 9.9pt; PADDING-BOTTOM: 1.4pt; BORDER-LEFT: medium none; WIDTH: 351.6pt; PADDING-TOP: 1.4pt; BORDER-BOTTOM: windowtext 1pt solid" valign="top" width="469">
<p class="a4" style="MARGIN-LEFT: 10.7pt"><span style="FONT-FAMILY: 宋体">描述属性</span></p>
</td>
</tr>
</tbody>
</table>
</div>
<p class="MsoNormal"><span lang="EN-US"> </span></p>
<p class="MsoNormal"><span style="FONT-FAMILY: 宋体">要了解它们的工作方式，可以在上一节的</span><span lang="EN-US">MathLibrary.cs</span><span style="FONT-FAMILY: 宋体">文件中添加一些</span><span lang="EN-US">XML</span><span style="FONT-FAMILY: 宋体">注释，并称之为</span><span lang="EN-US">Math.cs</span><span style="FONT-FAMILY: 宋体">。我们给类及其</span><span lang="EN-US">Add</span><span style="FONT-FAMILY: 宋体">方法添加一个</span><span lang="EN-US"><summary></span><span style="FONT-FAMILY: 宋体">注释，也给</span><span lang="EN-US">Add</span><span style="FONT-FAMILY: 宋体">方法添加一个</span><span lang="EN-US"><returns></span><span style="FONT-FAMILY: 宋体">元素和两个</span><span lang="EN-US"><param></span><span style="FONT-FAMILY: 宋体">元素：</span></p>
<p class="2" style="MARGIN: 8.15pt 0cm 0pt 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US">// Math.cs</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US">namespace Wrox.ProCSharp.Basics</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US">{</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> </span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> ///<summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> /// Wrox.ProCSharp.Basics.Math class.</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> /// Provides a method to add two integers.</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> ///</summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> public class Math</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> {</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> ///<summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> /// The Add method allows us to add two integers</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> ///</summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> ///<returns>Result of the addition (int)</returns></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> ///<param name="x">First number to add</param></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> ///<param name="y">Second number to add</param></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> public int Add(int x, int y)</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> {</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> return x + y;</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> }</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> }</span></p>
<p class="2" style="MARGIN: 0cm 0cm 8.15pt 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US">}</span></p>
<p class="MsoNormal"><span lang="EN-US">C#</span><span style="FONT-FAMILY: 宋体">编译器可以把</span><span lang="EN-US">XML</span><span style="FONT-FAMILY: 宋体">元素从特定的注释中提取出来，并使用它们生成一个</span><span lang="EN-US">XML</span><span style="FONT-FAMILY: 宋体">文件。要让编译器为程序集生成</span><span lang="EN-US">XML</span><span style="FONT-FAMILY: 宋体">文档说明，需在编译时指定</span><span lang="EN-US">/doc</span><span style="FONT-FAMILY: 宋体">选项，其后需跟上要被创建的文件的名称：</span></p>
<p class="a6" style="MARGIN: 8.15pt 0cm 8.15pt 21.45pt; TEXT-INDENT: 18.45pt"><strong><span lang="EN-US">csc /t:library /doc:Math.xml Math.cs</span></strong></p>
<p class="MsoNormal"><span style="FONT-FAMILY: 宋体">如果</span><span lang="EN-US">XML</span><span style="FONT-FAMILY: 宋体">注释没有生成格式正确的</span><span lang="EN-US">XML</span><span style="FONT-FAMILY: 宋体">文档，编译器就抛出一个错误。</span></p>
<p class="MsoNormal"><span style="FONT-FAMILY: 宋体">上面的代码会生成一个</span><span lang="EN-US">XML</span><span style="FONT-FAMILY: 宋体">文件</span><span lang="EN-US">Math.xml</span><span style="FONT-FAMILY: 宋体">，如下所示。</span></p>
<p class="2" style="MARGIN: 8.15pt 0cm 0pt 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"><?xml version="1.0"?></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"><doc></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <assembly></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <name>Math</name></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> </assembly></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <members></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <member name="T:Wrox.ProCSharp.Basics.Math"></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> Wrox.ProCSharp.Basics.Math class.</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> Provides a method to add two integers.</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> </summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> </member></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <member name=</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> "M:Wrox.ProCSharp.Basics.Math.Add(System.Int32,System.Int32)"></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> The Add method allows us to add two integers</span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> </summary></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <returns>Result of the addition (int)</returns></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <param name="x">First number to add</param></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> <param name="y">Second number to add</param></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> </member></span></p>
<p class="2" style="MARGIN-LEFT: 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"> </members></span></p>
<p class="2" style="MARGIN: 0cm 0cm 8.15pt 21.45pt; TEXT-INDENT: 18.45pt"><span lang="EN-US"></doc></span></p>
<p class="MsoNormal"><span style="FONT-FAMILY: 宋体">注意，编译器为我们做了一些工作<span style="LETTER-SPACING: -0.5pt">——</span>它创建了一个</span><span lang="EN-US"><assembly></span><span style="FONT-FAMILY: 宋体">元素，并为该文件中的每个类或类成员添加一个</span><span lang="EN-US"><member></span><span style="FONT-FAMILY: 宋体">元素。每个</span><span lang="EN-US"><member></span><span style="FONT-FAMILY: 宋体">元素都有一个</span><span lang="EN-US">name</span><span style="FONT-FAMILY: 宋体">特性，其中包含成员的全名，前面有一个字母表示其类型：</span><span lang="EN-US">"T:"</span><span style="FONT-FAMILY: 宋体">表示这是一个类型，</span><span lang="EN-US">"F:" </span><span style="FONT-FAMILY: 宋体">表示这是一个字段，</span><span lang="EN-US">"M:" </span><span style="FONT-FAMILY: 宋体">表示这是一个成员。</span></p></div>
<!-- page -->
<div class="page" style="text-align: center">
<a href="100162748.htm">上一页</a> <a href="index.html">首页</a> <a href="100162750.htm">下一页</a>
</div>
<div style="margin: 0px auto; width: 700px; border: solid 1px #0b5f98;">
<div style="float: left; width: 16px; background-color: #0b5f98; color: White; padding: 1px;">
图书导读
</div>
<div style="float: right; width: 670px; text-align: left; line-height: 16pt; padding-left: 2px">
<!--导读-->
<h1 id="divCurrentNode2" style="color: #b83507; width: 100%; text-align: left; font-size: 12px; padding-left: 2px">当前章节:<a href='100162749.htm'><font color='red'>2.12 使用注释</font></a></h1>
<div id="divRealteNod2" style="padding-left: 2px">
<div style='float:left;width:49%'>·<a href='100162746.htm'>2.9 Main()方法</a></div><div style='float:right;width:49%'>·<a href='100162747.htm'>2.10 有关编译C#文件的更多内容</a></div><div style='float:left;width:49%'>·<a href='100162748.htm'>2.11 控制台I/O</a></div><div style='float:right;width:49%'>·<a href='100162750.htm'>2.13 C#预处理器指令</a></div><div style='float:left;width:49%'>·<a href='100162751.htm'>2.14 C#编程规则</a></div><div style='float:right;width:49%'>·<a href='100162752.htm'>2.15 小结</a></div></div>
</div>
</div>
</div>
</div>
</body>
</html>
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?