Чтение онлайн

на главную

Жанры

Полное руководство. С# 4.0
Шрифт:

пояснение Документирует параметр типа, на который указывает имя_параметра. Текст, обозна чаемый как пояснение, описывает пара метр типа

Обозначает имя_параметра

как имя пара метра типа 1042 Часть II. Библиотека C# // Пример составления документирующих комментариев. using System; /* Это пример многострочного документирования в формате XML. В классе Test демонстрируется ряд дескрипторов. / class Test { /// /// Выполнение программы начинается с метода Main. /// static void Main { int sum; sum = Summation(5); Console.WriteLine("Сумма последовательных чисел " + 5 + " равна " + sum); } /// /// Метод Summation возвращает сумму его аргументов. /// /// Суммируемое значение передается в качестве параметра val. /// /// /// /// Сумма возвращается в виде значения типа int. /// /// static int Summation(int val) { int result = 0; for(int i=l; i <= val; i++) result += i; return result; } } Если текст приведенной выше программы содержится в файле XmlTest.cs, то по следующей команде будет скомпилирована программа и получен файл XmlTest.xml, содержащий комментарии к ней. csc XmlTest.cs /doc:XmlTest.xml После компилирования получается XML-файл, содержимое которого приведено ниже. <?xml version="l.0"?>

DocTest

Это пример многострочного документирования в формате XML. В классе Test демонстрируется ряд дескрипторов.

Выполнение программы начинается с метода Main.

Метод Summation возвращает сумму его аргументов.

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

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

Поделиться:
Популярные книги

Вперед в прошлое 3

Ратманов Денис
3. Вперёд в прошлое
Фантастика:
попаданцы
альтернативная история
5.00
рейтинг книги
Вперед в прошлое 3

Никто и звать никак

Ром Полина
Фантастика:
фэнтези
7.18
рейтинг книги
Никто и звать никак

Мятежник

Прокофьев Роман Юрьевич
4. Стеллар
Фантастика:
боевая фантастика
7.39
рейтинг книги
Мятежник

Пропала, или Как влюбить в себя жену

Юнина Наталья
2. Исцели меня
Любовные романы:
современные любовные романы
6.70
рейтинг книги
Пропала, или Как влюбить в себя жену

Темный Патриарх Светлого Рода 6

Лисицин Евгений
6. Темный Патриарх Светлого Рода
Фантастика:
фэнтези
попаданцы
аниме
5.00
рейтинг книги
Темный Патриарх Светлого Рода 6

Случайная мама

Ручей Наталья
4. Случайный
Любовные романы:
современные любовные романы
6.78
рейтинг книги
Случайная мама

На границе империй. Том 8

INDIGO
12. Фортуна дама переменчивая
Фантастика:
космическая фантастика
попаданцы
5.00
рейтинг книги
На границе империй. Том 8

Сердце Дракона. Том 19. Часть 1

Клеванский Кирилл Сергеевич
19. Сердце дракона
Фантастика:
фэнтези
героическая фантастика
боевая фантастика
7.52
рейтинг книги
Сердце Дракона. Том 19. Часть 1

Кодекс Охотника. Книга V

Винокуров Юрий
5. Кодекс Охотника
Фантастика:
фэнтези
попаданцы
аниме
4.50
рейтинг книги
Кодекс Охотника. Книга V

Дракон - не подарок

Суббота Светлана
2. Королевская академия Драко
Фантастика:
фэнтези
6.74
рейтинг книги
Дракон - не подарок

Беглец

Кораблев Родион
15. Другая сторона
Фантастика:
боевая фантастика
попаданцы
рпг
5.00
рейтинг книги
Беглец

Хозяйка старой усадьбы

Скор Элен
Любовные романы:
любовно-фантастические романы
8.07
рейтинг книги
Хозяйка старой усадьбы

Развод и девичья фамилия

Зика Натаэль
Любовные романы:
современные любовные романы
5.25
рейтинг книги
Развод и девичья фамилия

Я еще не князь. Книга XIV

Дрейк Сириус
14. Дорогой барон!
Фантастика:
юмористическое фэнтези
попаданцы
аниме
5.00
рейтинг книги
Я еще не князь. Книга XIV