Поделиться через


Условные обозначения и соглашения о коде (Visual Basic)

В документации по Visual Basic используются следующие условные обозначения и соглашения о коде.

Условные обозначения

Пример

Описание

Sub, If, ChDir, Print, True, Debug

Ключевые слова конкретного языка и члены среды выполнения имеют начальные прописные буквы и форматируются как показано в этом примере.

SmallProject, ButtonCollection

Слова и фразы, которые следует ввести, форматируются как показано в этом примере.

Оператор Module

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

object, имя_переменной, argumentList

Пустые местозаполнители для сведений, предоставляемых пользователем, форматируются как показано в этом примере.

[ Shadows ], [ список_выражений ]

В синтаксисе необязательные элементы заключены в кавычки.

{ Public | Friend | Private }

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

Необходимо выбрать только один из этих элементов.

[ Protected | Friend ]

Если предоставляется возможность выбора из нескольких элементов, такие элементы в синтаксисе заключаются в квадратные скобки и разделяются вертикальной чертой.

Можно выбрать любое сочетание элементов, или не указывать элементы вообще.

[{ ByVal | ByRef }]

В синтаксисе, когда можно выбрать не более одного элемента, но можно также опустить элементы полностью, каждый элемент заключен в квадратные скобки, а элементы разделяются вертикальной чертой. Весь список элементов также полностью заключается в квадратные скобки.

имя_члена1, имя_члена2, имя_члена3

Несколько экземпляров, располагающихся в одной позиции, различаются по нижним индексам, как показано в примере.

имя_члена1

...

имя_членаN

В синтаксисе многоточие (...) используется для указания неопределенного числа элементов сразу перед многоточием.

В коде многоточия обозначают часть кода, опущенного для простоты.

ESC, ВВОД

Названия клавиш и последовательность клавиш на клавиатуре всегда отображаются в верхнем регистре.

ALT+F1

Знак "плюс" (+) между названиями клавиш, означает, что необходимо удерживать нажатой одну клавишу при нажатии второй. Например, ALT+F1 означает, что следует нажать клавишу F1, удерживая нажатой клавишу ALT.

Соглашения о коде

Пример

Описание

sampleString = "Hello, world!"

Код отображается моноширинным шрифтом, и форматируется как показано в этом примере.

Предыдущий оператор устанавливает значение sampleString в "Hello, world!".

Пояснительный текст к элементам кода оформляется моноширинным шрифтом, как показано в примере.

' This is a comment.

REM This is also a comment.

Перед комментариями к коду ставится знак апострофа (') или ключевое слово REM.

sampleVar = "This is an " _

& "example" _

& " of how to continue code."

Знаки пробела и подчеркивания ( _) в конце строки указывают на то, что инструкция продолжается в следующей строке.

См. также

Задачи

Практическое руководство. Разбиение и объединение инструкций в коде (Visual Basic)

Ссылки

Члены библиотеки времени выполнения Visual Basic

Основные понятия

Соглашения об именах Visual Basic

Комментарии в коде (Visual Basic)

Другие ресурсы

Справочник по языку Visual Basic

Ключевые слова (Visual Basic)