Компьютерные книги
Главное меню
Главная Поиск по сайту Добавить материал О нас Карта книг Карта сайта
Реклама
computersbooks.net -> Добавить материал -> Языки программирования -> Ватсон К. -> "С#" -> 238

С# - Ватсон К.

Ватсон К. С# — Лори, 2005 . — 879 c.
ISBN 1-861004-98-2
Скачать (прямая ссылка): vatsonc2005.pdf
Предыдущая << 1 .. 232 233 234 235 236 237 < 238 > 239 240 241 242 243 244 .. 404 >> Следующая


III <summary>

/// Этот класс создает множества Мандельброта в консольной окне! Ill </вштлгу>
512

Глава 18

I

il

class Clusl (

III <9un»oecy>

m I

III </8ШтАсу>

III <patara ne»e“"eroe"></paraiD> static void Hain(3tcintf[] args) (

3. Теперь создадим некоторую документацию для метода Main (). Добавьте пустую строку перед началом определения метода н введите три слэша (см. рис, слева). Смотрите, что произойдет после этого!

VS добавляет XML-теги для элемента <aummary> (такого же, как тот, что использовался в классе class 1), однако кроме того, VS просматривает следующую строку, распознает в ней описание метода и выделяет его параметры. После этого для каждого параметра создается элемент <param> (в данном случае у нас есть единственный параметр — строковый массив с именем args, который может использоваться для считывания данных из командной строки и процессе выполнения приложения). Имя параметра при этом помещается в атрибут паше.

4. Добавьте некоторое описание в элементы <summary> и <рагаш>:

III <euimnery>

/// Это метод Main!) для класса Classl

Ill именно Здесь нами вызывается генератор Мандельброта.!

Ill summary»

///¦eparam name--args“>

III Параметр args используется для считывания аргументов,

III передаваемых из окна консоли.

Ill </param>

Обратите внимание на то, что VS знает, что вы находитесь в процессе набора комментариев для автодокументирования, и когда вы достигаете конца строки и нажимаете Enter, происходит автоматическое добавление трех слэшей иа новой строке!

5. Теперь попытаемся преобразовать все эти комментарии в документацию. Выберите пункт меню Tools J Build Comment Web Pages..., откроется диалоговое окно, представленное на рисунке справа.

Если наше VS решение состоит более чем из одного проекта, можно определить здесь, следует ли создавать документацию для всего решения или только для отдельных проектов. Поскольку данное решение включает в себя только один проект, то оставьте выбранной опцию Build for Entire Solution (построение для всего решения). Можно также указать директорию, в которой будут сохраняться сгенерированные web-страннцы.

Ruilii cdtjmnent Wfib P<tQ«

Build for entire Solution Г Build for selected Projects:

ill

Save Web Pages in; ,

C;\BegC5harp\Chapter‘t\ChCHEx06 Browse,^

Г“ Add to fa*;* t4s

OK

Cancel

Help

6. Щелкните мышью на OK, заставив тем самым VS сгенерировать web-страннцы. Internet Explorer входит в состав VS, поэтому когда мы нажимаем OK, VS автоматически выводит на экран основную страницу документации для данного решения (см, след. рис.).
Доступ к данным пользователя

513

Code Comment Web Report

Ch04Ex06 Solution

Г Project Description ]
Ch04Ex06



7. Щелкните мышью на ссылке ch04Ex06 — это приведет к открытию страницы документации для нашего проекта (единственного для данного решения):

; I Code Comment Web Report
Shirt's n 1 й rti/< rj - - ' ж
S Ch04Ex06 : Ch04Ex06 Project
Ciassl
<1 j fc.jj jfj

8. Откройте документацию для класса ciassl, щелкнув мышью

на значке "плюс", расположенном рядом со ссылкой на ch04Ex06, а затем щелкните мышью на ссылке на ciassl, которая появится ниже:

Code Comment Web Report

Э СЬй4Ем0б

CUttl

Ch04Ex06.Classl Class

Ttu't ctafs gcrwata* MaftdeNjrol sett in the corttaJ* window!

Acccdi Project Base Cloffo*: Object

ШШШЭМННШВ U^cridtlun 1
Main Th\t is th« HauiC '< rtethad far Cf«*l ¦ tin» h whir* ме cjfl tfic ri*rKJtitvot оетдЮг!

J -»liL
514

Глава 18

Здесь можно увидеть страницы, сгенерированные на основе наших комментариев. Страница документации, посвященная нашему классу, содержит введенное общее описание класса, список членов класса с общим описанием для каждого из них. В ней также содержится некоторая дополнительная информация, используемая VS для собственных нужд, — полное имя класса, включая пространство имен, уровень доступа к классу, а также класс, от которого данный класс происходит.

9. В завершение щелкните мышью на ссылке Main,

для того чтобы просмотреть документацию по методу Mai.no.

На этой странице выводятся описание метода и его параметра,

а также его сигнатура:
Code Comment Web Report
i • - - - - -- ¦ 4
В Ch04C«06 Clllll Ch04Ex06.Classl.Maln Function This is the KdinO method for Cleffl • thit it where we «II the Mer.delbret generator! Privet* «Old Hein (itHnpt]}
кпп&ага» |n*1 piremltir li mad 3 read ;ri Arguments pitied from the cqpsoJ* wirxtow — 7- i mmf P i void . -d
4l ‘ i::*U [... . . . _ . .. . • . i »r

К сожалению, эта страница не слишком хорошо отформатирована — описание параметра ares выглядит не очень красиво.

Итоги

Visual Studio.NET предоставляет целый спектр инструментов, предназначенных для быстрого создания приложений, которые позволяют работать с базами данных. Самое замечательное — для этого не приходится писать почти никакого кода. На протяжении данной главы мы рассмотрели несколько механизмов вывода данных. Начиная с основополагающего текстового окна и заканчивая более сложной сеткой данных,— все они основываются на мощных возможностях и гибкости ADO.NET и объекта BindingContext, имеющегося в каждой форме Windows
Предыдущая << 1 .. 232 233 234 235 236 237 < 238 > 239 240 241 242 243 244 .. 404 >> Следующая
Книги
Web-программирован-
ие
Аппаратное обеспечение Графика Руководство по П.О. Самоучитель Теория программирования Фотошоп Языки программирования
Новые книги
Вирт Н. "Систематическое программирование " (Теория программирования)

Эком "Microsoft Excel 2000 шаг за шагом Русская версия самоучитель " (Самоучитель)

Поляков А.Ю. "Методы и алгоритмы компьютерной графики в примерах Vizual C++" (Графика)

Баяковский Ю.М. "Графическая библиотека Open GL " (Графика)

Валиков А. "Технология " (Языки программирования)
Авторские права © 2013 ComputersBooks. Все права защищены.