C# 4.0: полное руководство

<b>  ///&lt;/summary&gt;</b>

<b>  static void Main() {</b>

<b>    int sum;</b>

<b>    sum = Summation(5);</b>

<b>    Console.WriteLine(&quot;Сумма последовательных чисел &quot; +</b>

<b>    5 + &quot; равна &quot; + sum);</b>

<b>  }</b>

<b>  ///&lt;summary&gt;</b>

<b>  /// Метод Summation() возвращает сумму его аргументов.</b>

<b>  ///&lt;param name = &quot;val&quot; &gt;</b>

<b>  /// Суммируемое значение передается в качестве параметра val.</b>

<b>  ///&lt;/param&gt;</b>

<b>  ///&lt;see cref = &quot;int&quot; &gt; &lt;/ see &gt;</b>

<b>  /// &lt; returns &gt;</b>

<b>  /// Сумма возвращается в виде значения типа int.</b>

<b>  ///&lt;/returns&gt;</b>

<b>  /// &lt;/summary&gt;</b>

<b>  static int Summation(int val) {</b>

<b>    int result = 0;</b>

<b>    for (int i = 1; i &lt;= val; i++)</b>

<b>      result += i;</b>

<b>    return result;</b>

<b>  }</b>

<b>}</b>

Если текст приведенной выше программы содержится в файле XmlTest.cs, то по следующей команде будет скомпилирована программа и получен файл XmlTest.xml, содержащий комментарии к ней.

<b>csc XmlTest.cs /doc:XmlTest.xml</b>

После компилирования получается XML-файл, содержимое которого приведено ниже.

<b>&lt;?xml version=&quot;1.0&quot;?&gt;</b>

<b>&lt;doc&gt;</b>

<b>    &lt;assembly&gt;</b>

<b>        &lt;name&gt;Program&lt;/name&gt;</b>

<b>    &lt;/assembly&gt;</b>

<b>    &lt;members&gt;</b>

<b>        &lt;member name=&quot;T:Test&quot;&gt;</b>

<b>            &lt;remark&gt;</b>

<b>            Это пример многострочного документирования в формате XML.</b>

<b>            В классе Test демонстрируется ряд дескрипторов.</b>

<b>            &lt;/remark&gt;</b>

<b>        &lt;/member&gt;</b>

<b>        &lt;member name=&quot;M:Test.Main&quot;&gt;</b>

<b>            &lt;summary&gt;</b>

<b>             Выполнение программы начинается с метода Main().</b>

<b>            &lt;/summary&gt;</b>

<b>        &lt;/member&gt;</b>

<b>        &lt;member name=&quot;M:Test.Summation(System.Int32)&quot;&gt;</b>

<b>            &lt;summary&gt;</b>

<b>             Метод Summation() возвращает сумму его аргументов.</b>

<b>            &lt;param name=&quot;val&quot;&gt;</b>

<b>             Суммируемое значение передается в качестве параметра val.</b>

<b>            &lt;/param&gt;</b>

<b>            &lt;see cref=&quot;T:System.Int32&quot;&gt; &lt;/see&gt;</b>

<b>             &lt;returns&gt;</b>

<b>             Сумма возвращается в виде значения типа int.</b>

<b>            &lt;/returns&gt;</b>

<b>             &lt;/summary&gt;</b>

<b>        &lt;/member&gt;</b>

<b>    &lt;/members&gt;</b>

<b>&lt;/doc&gt;</b>

Следует заметить, что каждому документируемому элементу присваивается уникальный идентификатор. Такие идентификаторы применяются в других программах, которые документируются в формате XML.

Предметный указатель

(Удален. Все-равно номеров страниц нет. См. Оригинал)

Спецификации

HERBERT SCHILDT ПОЛНОЕ РУКОВОДСТВО C# 4.0

Москва • Санкт-Петербург • Киев 2011

ББК 32.973.26-018.2.75 Ш 57 УДК 681.3.07

Издательский дом "Вильямс"

Зав. редакцией С.Н. Тригуб Перевод с английского и редакция И.В. Берштейна

По общим вопросам обращайтесь в Издательский дом "Вильямс" по адресу: [email protected]/* */, http://www.williamspublishing.com

Шилдт, Герберт.

Ш57 C# 4.0: полное руководство. : Пер. с англ. — М. : ООО "И.Д. Вильямс", 2011. — 1056 с.: ил. — Парал. тит. англ.

ISBN 978-5-8459-1684-6 (рус.)

ББК 32.973.26-018.2.75

Все названия программных продуктов являются зарегистрированными торговыми марками соответствующих фирм.

Никакая часть настоящего издания ни в каких целях не может быть воспроизведена в какой бы то ни было форме и какими бы то ни было средствами, будь то электронные или механические, включая фотокопирование и запись на магнитный носитель, если на это нет письменного разрешения издательства McGrow-Hill Higher Ed.