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

/win32manifest (параметры компилятора C#)

  • Статья

Параметр /win32manifest используется для указания пользовательского файла манифеста приложения Win32, который необходимо внедрить в PE-файл проекта.

/win32manifest: filename

Аргументы

  • filename
    Имя и расположение пользовательского файла манифеста.

Заметки

По умолчанию компилятор Visual C# внедряет манифест приложения, который указывает запрошенный уровень "asInvoker". Он создает манифест в той же папке, в которой выполняется построение исполняемого файла, как правило — в папке bin\Debug или bin\Release, если используется Visual Studio. Если вы хотите предоставить пользовательский манифест, например, чтобы указать в качестве требуемого уровня выполнения highestAvailable или requireAdministrator, используйте этот параметр для указания имени файла.

ПримечаниеПримечание

Этот параметр и параметр /win32res (параметры компилятора C#) являются взаимно исключающими.При попытке использовать оба параметра в одной командной строке создается ошибка построения.

Приложение, не имеющее манифеста приложения, который указывает запрошенный уровень выполнения, будет виртуализовано файлом/реестром посредством функции контроля учетных записей в Windows Vista.Дополнительные сведения о виртуализации см. в статье Статья для разработчиков под Windows Vista: требования к разработке приложений с точки зрения механизма управления учетными записями пользователей (UAC).

Приложение подлежит виртуализации, если выполняется одно из указанных ниже условий.

  • Если используется параметр /nowin32manifest и не предоставляется манифест на более поздней стадии построения, или как часть файла Windows ресурсов (.res) с помощью параметра /win32res.

  • Необходимо предоставить пользовательский манифест, который не указывает запрошенный уровень выполнения.

Visual Studio создает стандартный файл манифеста и сохраняет его в каталоге отладки и выпуска наряду с исполняемым файлом.Пользовательский манифест можно добавить, создав его в любом текстовом редакторе и добавив полученный файл к проекту.Можно также щелкнуть правой кнопкой мыши значок Проект в обозревателе решений, выбрать команду Добавить новый элемент, а затем щелкнуть пункт Файл манифеста приложения.После добавления нового или существующего файла манифеста этот файл появится в раскрывающемся списке Манифест.Дополнительные сведения см. в разделе Страница "Приложение" в конструкторе проектов (C#).

Можно предоставить манифест приложения в качестве пользовательской последующей за построением стадии, или как часть файла ресурсов Win32, с помощью параметра /nowin32manifest (параметры компилятора C#).Используйте этот же параметр, если требуется приложение, которое будет использовать файл или системный реестр виртуализации в Windows Vista.Это не позволит компилятору создать манифест по умолчанию и внедрить его в PE-файл.

Пример

В следующем примере показан манифест, который компилятор Visual C# по умолчанию вставляет в PE-файл.

ПримечаниеПримечание

Компилятор вставляет стандартное имя приложения "MyApplication.App" в XML-файл.Это делается для того, чтобы позволить приложениям работать в Windows Server 2003 с пакетом обновления 3.

 
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <assemblyIdentity version="1.0.0.0" name="MyApplication.app"/>
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
    <security>
      <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
        <requestedExecutionLevel level="asInvoker"/>
      </requestedPrivileges>
    </security>
  </trustInfo>
</assembly>

См. также

Задачи

Практическое руководство. Изменение свойств проекта и параметров конфигурации

Ссылки

/nowin32manifest (параметры компилятора C#)

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

Параметры компилятора C#