Страница "Компиляция" в конструкторе проектов (Visual Basic)

Страница Компиляция в конструкторе проектов служит для указания инструкций компиляции. На ней можно настроить дополнительные параметры компилятора, а также события, которые будут происходить до и после сборки.

Чтобы открыть страницу Компиляция, выберите в обозревателе решений узел проекта (не узел Решение). Затем в строке меню выберите Проект > Свойства. После того как откроется конструктор проектов, перейдите на вкладку Компиляция.

Конфигурация и платформа

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

Конфигурация

Указывает параметры конфигурации для отображения или изменения. Возможные параметры: Отладка (по умолчанию), Выпуск и Все конфигурации. Дополнительные сведения см. в описании конфигураций отладки и выпуска проекта и практическом руководстве по созданию и изменению конфигураций.

Платформа

Указывает параметры платформы для отображения или изменения. Можно указать Любой ЦП (по умолчанию), x64 или x86.

Параметры конфигурации компилятора

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

Выходной путь построения

Местоположение выходных файлов для конфигурации этого проекта. Введите в этом поле путь назначения сборки или нажмите кнопку Обзор и выберите папку. Обратите внимание, что путь является относительным. Если ввести абсолютный путь, он будет сохранен как относительный. Путь по умолчанию — bin\Debug\ или bin\Release\.

Если выбраны упрощенные конфигурации сборки, система проекта определяет, следует ли выполнять построение отладочной или окончательной версии. Команда Сборка из меню Отладка (F5) перемещает сборку в расположение отладки вне зависимости от заданного значения Путь для создаваемых файлов. Однако команда Сборка в меню Сборка позволяет поместить сборку в указанное расположение.

Option Explicit

Позволяет разрешить или запретить неявное объявление переменных. Чтобы сделать явное объявление переменных обязательным, выберите значение Вкл. В этом случае компилятор будет сообщать об ошибках, если используются необъявленные переменные. Чтобы разрешить неявное объявление переменных, выберите значение Выкл.

Этот параметр соответствует параметру компилятора /optionexplicit.

Если файл исходного кода содержит оператор Option Explicit, значение On или Off в операторе переопределяет параметр Option Explicit на странице Компиляция.

При создании проекта для параметра Option Explicit на странице Компиляция устанавливается значение параметра Option Explicit из диалогового окна Параметры. Чтобы просмотреть или изменить параметр в этом диалоговом окне, в меню Сервис выберите пункт Параметры. В диалоговом окне Параметры разверните узел Проекты и решения и выберите пункт Параметры Visual Basic по умолчанию. Первоначальное значение по умолчанию для параметра Option Explicit в узле Параметры Visual Basic по умолчанию — Вкл.

Устанавливать значение параметра Option Explicit равным Off, как правило, не рекомендуется. Вы можете допустить ошибку при вводе имени переменной в одном или нескольких местах, что приведет к непредвиденным результатам при выполнении программы.

Option Strict

Указывает, следует ли применять строгую семантику типов. Если для Option Strict задано значение Вкл, следующие условия вызывают ошибку во время компиляции:

• неявные сужающие преобразования;

• Позднее связывание

• неявная типизация, которая приводит к типу Object.

Ошибки неявных сужающих преобразований возникают при наличии неявного преобразования типа данных, которое является сужающим преобразованием. Дополнительные сведения см. в разделах Оператор Option Strict, Явные и неявные преобразования и Расширяющие и сужающие преобразования.

Позднее связывание объекта возникает при его присваивании свойству или методу переменной, объявленной с типом Object. Дополнительные сведения см. в разделах Оператор Option Strict и Раннее и позднее связывание.

Ошибки неявных типов объектов возникают, когда для объявленной переменной невозможно вывести соответствующий тип, поэтому выводится тип Object. Это происходит в основном при использовании оператора Dim для объявления переменной без использования предложения As, если параметр Option Infer отключен. Дополнительные сведения см. в разделах Оператор Option Strict, Option Infer — оператор и Спецификация языка Visual Basic.

Параметр Option Strict соответствует параметру компилятора /optionstrict.

Если файл исходного кода содержит оператор Option Strict, значение On или Off в операторе переопределяет параметр Option Strict на странице Компиляция.

При создании проекта для параметра Option Strict на странице Компиляция устанавливается значение параметра Option Strict из диалогового окна Параметры. Чтобы просмотреть или изменить параметр в этом диалоговом окне, в меню Сервис выберите пункт Параметры. В диалоговом окне Параметры разверните узел Проекты и решения и выберите пункт Параметры Visual Basic по умолчанию. Первоначальное значение по умолчанию для параметра Option Strict в узле Параметры Visual Basic по умолчанию — Выкл.

Отдельные предупреждения Option Strict

Раздел Конфигурации предупреждений на странице Компиляция содержит параметры, соответствующие трем условиям, вызывающим ошибку во время компиляции при включенном параметре Option Strict. Ниже приведены эти параметры.

• Неявное преобразование

• Позднее связывание; возможный сбой вызова во время выполнения

• Неявный тип; предполагается объект

При задании для параметра Option Strict значения Вкл для всех трех параметров конфигурации предупреждений задается значение Ошибка. При задании для параметра Option Strict значения Выкл для всех трех параметров задается значение Нет.

Вы можете задать для каждого отдельного параметра конфигурации предупреждений значение Нет, Предупреждение или Ошибка. Если всем трем параметрам конфигурации предупреждений присвоено значение Ошибка, в поле Option strict указывается значение On. Если всем трем параметрам присвоено значение Нет, в этом поле указывается значение Off. Для любого другого сочетания этих параметров указывается значение (пользовательский).

Option Compare

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

Этот параметр соответствует параметру компилятора /optioncompare.

Если файл исходного кода содержит оператор Option Compare, значение Binary или Text в операторе переопределяет параметр Option Compare на странице Компиляция.

При создании проекта для параметра Option Compare на странице Компиляция устанавливается значение параметра Option Compare из диалогового окна Параметры. Чтобы просмотреть или изменить параметр в этом диалоговом окне, в меню Сервис выберите пункт Параметры. В диалоговом окне Параметры разверните узел Проекты и решения и выберите пункт Параметры Visual Basic по умолчанию. Первоначальное значение по умолчанию для параметра Option Compare в узле Параметры Visual Basic по умолчанию — Двоичный.

Option infer

Позволяет разрешить или запретить вывод локального типа при объявлении переменной. Выберите Вкл, чтобы разрешить вывод локального типа. Чтобы запретить вывод локального типа, выберите значение Выкл.

Этот параметр соответствует параметру компилятора /optioninfer.

Если файл исходного кода содержит оператор Option Infer, значение On или Off в операторе переопределяет параметр Option Infer на странице Компиляция.

При создании проекта для параметра Option Infer на странице Компиляция устанавливается значение параметра Option Infer из диалогового окна Параметры. Чтобы просмотреть или изменить параметр в этом диалоговом окне, в меню Сервис выберите пункт Параметры. В диалоговом окне Параметры разверните узел Проекты и решения и выберите пункт Параметры Visual Basic по умолчанию. Первоначальное значение по умолчанию для параметра Option Infer в узле Параметры Visual Basic по умолчанию — Вкл.

Целевой ЦП

Указывает целевой процессор для выходного файла. Выберите x86 для любого 32-разрядного процессора, совместимого с Intel, x64 для любого 64-разрядного процессора, совместимого с Intel, ARM для любого процессора ARM или Любой ЦП, чтобы указать, что допустим любой процессор. Любой ЦП является значением по умолчанию для новых проектов, так как обеспечивает выполнение приложения на самом обширном спектре оборудования.

Дополнительные сведения см. в разделе /platform (Visual Basic).

Предпочитать 32-разрядную

Если флажок Предпочитать 32-разрядную установлен, приложение выполняется как 32-разрядное в 32- и 64-разрядных версиях Windows. В противном случае приложение выполняется как 32-разрядное приложение в 32-разрядных версиях Windows и как 64-разрядное приложение в 64-разрядных версиях Windows.

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

Этот флажок доступен, только если верны все следующие условия:

• На странице Компиляцияв списке Целевой ЦП выбрано значение Любой ЦП.

• На странице Приложение в списке Тип приложения указано, что проект является приложением.

• На странице Приложение в списке Целевая рабочая среда указана .NET Framework 4.5.

Конфигурации предупреждений

В этой таблице перечислены условия сборки и соответствующие им уровни уведомлений (Нет, Предупреждение или Ошибка).

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

Выключить все предупреждения

Позволяет разрешить или запретить компилятору создавать уведомления, описанные в таблице Условия и уведомления ранее в этом документе. По умолчанию этот флажок снят. Установите этот флажок, чтобы отключить создание предупреждений и сообщений об ошибках компилятором.

Этот параметр соответствует параметру компилятора /nowarn.

Обрабатывать все предупреждения как ошибки

Определяет способ обработки предупреждений. По умолчанию этот флажок снят, то есть все предупреждения имеют состояние Предупреждение. Установите этот флажок, чтобы все предупреждения имели состояние Ошибка.

Этот параметр доступен лишь в том случае, если снят флажок Выключить все предупреждения.

Создать XML-файл документации

Определяет, нужно ли создавать документацию. По умолчанию этот флажок установлен, то есть компилятор создает документацию и включает ее в XML-файл. Чтобы документация не создавалась, снимите этот флажок.

Этот параметр соответствует параметру компилятора /doc.

Регистрация для COM-взаимодействия

Указывает, должно ли управляемое приложение предоставлять COM-объект (вызываемую оболочку COM), что позволяет COM-объекту взаимодействовать с приложением.

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

Этот параметр недоступен для проектов типа "Приложение Windows" и "Консольное приложение".

События сборки

Нажмите эту кнопку, чтобы открыть диалоговое окно События сборки. В нем можно указать инструкции, которые должны выполняться до и после сборки проекта. Это окно применяется только к проектам Visual Basic. Дополнительные сведения см. в разделе Диалоговое окно "События сборки" (Visual Basic).

Дополнительные параметры компиляции

Нажмите эту кнопку, чтобы открыть диалоговое окно Дополнительные параметры компиляции. Используйте диалоговое окно Дополнительные параметры компилятора, чтобы указать дополнительные параметры конфигурации сборки проекта. Это окно применяется только к проектам Visual Basic. Дополнительные сведения см. в разделе Диалоговое окно "Дополнительные параметры компилятора" (Visual Basic).

См. также

• Практическое руководство. Указание событий сборки (Visual Basic)
• Компилятор Visual Basic с интерфейсом командной строки
• Практическое руководство. Создание и изменение конфигураций