Условные обозначения и соглашения о коде (Visual Basic)
В документации по Visual Basic используются следующие условные обозначения и соглашения о коде.
Условные обозначения
Пример |
Описание |
---|---|
Sub, If, ChDir, Print, True, Debug |
Ключевые слова конкретного языка и члены среды выполнения имеют начальные прописные буквы и форматируются как показано в этом примере. |
SmallProject, ButtonCollection |
Слова и фразы, которые следует ввести, форматируются как показано в этом примере. |
Ссылки, которые можно щелкнуть для перехода на другую страницу справки, форматируются как показано в этом примере. |
|
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)