Написание кода ASP.NET и HTML. Комментирование кода. Код, продолжающийся на множество строк

Комментарии — пояснения к исходному тексту программы, находящиеся непосредственно внутри комментируемого кода. Синтаксис комментариев определяется языком программирования. Комментарии не оказывают никакого влияния на результат компиляции программы или её интерпретацию.

Хорошим стилем программирования считается начинать все процедуры с краткого комментария, описывающего функциональные характеристики процедуры (то, что она делает).

Для различных языков программирования существует различный синтаксис.

Примеры комментариев:

Для языка C#

/*Этот многострочный комментарий

мы перенесем на несколько

строк, чтобы показать его синтаксис*/

//А это однострочный комментарий

Для языка HTML:

<!-- Многострочный комментарий -->

Для языка Visual Basic:

Label1.Text = "Привет, мир!"

'Мы присвоили элементу Label текст

Если комментарий занимает более одной строки, каждая строка должна начинаться с символа начала комментария:

'Этот комментарий слишком длинный, чтобы поместиться на одной строке, поэтому мы

'разбиваем его на две строки. Для некоторых комментариев необходимо три и более строк'

Ссылки:

1. О комментариях, википедия.

http://ru.wikipedia.org/wiki/%D0%9A%D0%BE%D0%BC%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%80%D0%B8%D0%B8_(%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5)

2. Комментирование в Visual Basic

http://msdn.microsoft.com/ru-ru/library/bx185bk6.aspx

8 Приложение ASP.NET. Компиляция ASP.NET. Импорт пространств имен|Приложение ASP.NET. Компиляция ASP.NET. Импорт пространств имен

Более подробно о компиляции ASP.NET

Когда вы создаете, а затем компилируете страницу ASP.NET, то она становится реально существующим объектом. В этом объекте имеются свои свойства и методы, и все они выведены из System.Web.UI.Page. Каждая страница ASP.NET — это просто очередной объект, построенный по этой схеме. Таким образом, страница ASP.NET является расширением.NET Framework (структуры NET), созданным с помощью добавления индивидуальных возможностей.

Схема для чистого языка HTML, - называется классом System.Web.UI.LiteralControl. Так что HTML также является частью структуры.NET.

Импорт пространств имен

Каждое пространство имен (namespace) из структуры.NET — это, в сущности, кол-

лекция схем. Получить доступ к этим дополнительным объектам и методам можно с помощью ключевого слова Import (импорт):

<% Import Namespace="System.Drawing" %>

Эта строка задает импорт всех классов из пространства имен System.Drawing, например, font (шрифт) или image (изображение). Кроме того, вы можете импортировать свои собственные пространства имен. А вот пространства имен, которые по

умолчанию импортируются в каждую страницу ASP.NET автоматически:

• System

• System.Collection

• System.IO

Импортировать пространство имен, чтобы использовать его объекты, не нужно— для этого есть метод полегче. Например, в своей странице ASP.NET вы можете использовать

dim objFile as File

File (файл)— это часть пространства имен System.I0. И даже если это пространство имен не импортировано, то нужный объект вы все равно сможете использовать. Надо только изменить предыдущий синтаксис: