Отправляет email-рассылки с помощью сервиса Sendsay

Visual Basic.NET. Уроки

  Все выпуски  

Visual Basic.NET. Уроки Урок 56. XML-комментарии


Уроки по Visual Basic.NET. Рассылки сайта progs.biz
Выпуск № 87
 
Начало > VB.NET > Основы > Урок 56

Дино Эспозито
Microsoft ASP.NET 2.0. Углубленное изучение.
Дино Эспозито. Microsoft ASP.NET 2.0. Углубленное изучение
Заказать на Озоне

Подробнее


Полные версии уроков (с картинками): урок 56.

Основы VB.NET
Урок 56. XML-комментарии

Наконец-то в VB появились XML-комментарии. Раньше такие комментарии существовали только для C#. Такие комментарии позволяют создавать автоматически документацию к вашему коду.

XML-комментарии в VB начинаются с трех символов апострофа. При этом достаточно только поставить перед объявлением метода (свойства и т. д.) класса (структуры и т. п.) три символа апострофа - остальное Visual Studio поставит сама. Так, например, будет выглядеть атоматически сгенегированный XML-комментарий для метода с параметром:

    ''' <summary>
    ''' 
    ''' </summary>
    ''' <param name="a"></param>
    ''' <returns></returns>
    ''' <remarks></remarks>
    Function SomeFunction(ByVal a As Integer) As Boolean

    End Function

Вам остается только заполнить XML-комментарий соотвествующими значениями:

    ''' <summary>
    ''' SomeFunction function with parameter.
    ''' </summary>
    ''' <param name="a">Integer parameter</param>
    ''' <returns>Result</returns>
    ''' <remarks>Some note.</remarks>
    Function SomeFunction(ByVal a As Integer) As Boolean

    End Function

После этого добавленые комментарии появятся, например, в Object Browser (появляется по F2).

Рассылки сайта progs.biz
Visual C++, MFC
C# и .NET
VB.NET
ASP.NET
Win API
C/C++
Delphi
Java
HTML, PHP, mySQL, WEB-дизайн
Flash MX
C++ Builder
Ассемблер
SQL Server
DirectX
Обзор книг
Обзор программ
Новости сайта progs.biz


PARKING.RU. Качественный ВИРТУАЛЬНЫЙ ХОСТИНГ на платформе Windows(r): поддержка NET, многофункциональная панель управления, аренда бизнес-приложений, сертифицированные специалисты. Управляемый ВЫДЕЛЕННЫЙ ХОСТИНГ на платформе Windows(r): производительные серверы, профессиональная поддержка, аренда ПО Microsoft(r), безопасность, гарантии. http://www.parking.ru


Копирование любых материалов сайта без разрешения авторов и владельцев сайта запрещено.
© 2002-2007 сайт progs.biz
© 2002-2007 Игорь Алексеев

В избранное