/win32manifest (Importazione di un file manifesto Win32 personalizzato) (Opzioni del compilatore C#)

Aggiornamento: novembre 2007

Utilizzare l'opzione /win32manifest per specificare un file manifesto dell'applicazione Win32 definito dall'utente da incorporare nel file eseguibile di tipo PE di un progetto.

/win32manifest: filename

Argomenti

  • filename
    Nome e percorso del file manifesto personalizzato.

Note

Per impostazione predefinita, il compilatore Visual C# incorpora un manifesto di applicazione che specifica un livello di esecuzione obbligatorio di "asInvoker". Crea il manifesto nella stessa cartella nella quale viene compilato il file eseguibile, in genere la cartella bin\Debug o bin\Release quando si utilizza Visual Studio. Se si desidera fornire un manifesto personalizzato, ad esempio per specificare un livello di esecuzione richiesto "highestAvailable" o "requireAdministrator", utilizzare questa opzione per specificare il nome del file.

Nota:

Questa opzione e l'opzione /win32res (importazione di un file di risorse Win32) (opzioni del compilatore C#) si escludono a vicenda. Se si tenta di utilizzare entrambe le opzioni nella stessa riga di comando, si otterrà un errore di compilazione.

Un'applicazione che non ha alcun manifesto di applicazione che specifica un livello di esecuzione obbligatorio sarà soggetto alla virtualizzazione di file/Registro di sistema nella funzionalità Controllo account utente in Windows Vista. Per ulteriori informazioni sulla virtualizzazione, vedere i requisiti di sviluppo delle applicazioni di Windows Vista per il controllo dell'account utente (UAC) (informazioni in lingua inglese).

L'applicazione sarà soggetta a virtualizzazione se si verifica una delle seguenti condizioni:

  • Si utilizza l'opzione /nowin32manifest e non si fornisce un manifesto in una successiva istruzione di compilazione o come parte di file di risorse Windows (res) utilizzando l'opzione /win32res.

  • Si fornisce un manifesto personalizzato che non specifica un livello di esecuzione obbligatorio.

Visual Studio crea un file manifesto predefinito e lo archivia nelle directory Debug e Release insieme al file eseguibile. È possibile aggiungere un manifesto personalizzato creandone uno in qualsiasi editor di testo e aggiungendolo quindi al progetto. In alternativa, è possibile fare clic con il pulsante destro del mouse sull'icona Progetto in Esplora soluzioni, fare clic su Aggiungi nuovo elemento e quindi su File manifesto applicazione. Dopo avere aggiunto il file manifesto nuovo o esistente, verrà visualizzato nell'elenco a discesa Manifesto. Per ulteriori informazioni, vedere Pagina Applicazione, Progettazione progetti (C#).

È possibile fornire il manifesto di applicazione come passaggio post-compilazione personalizzato o come parte di un file di risorse Win32 utilizzando l'opzione /nowin32manifest (Nessun manifesto Win32) (Opzioni del compilatore C#). Utilizzare la stessa opzione se si desidera che l'applicazione sia soggetta alla virtualizzazione di file o al Registro di sistema in Windows Vista. In questo modo il compilatore non creerà né incorporerà un manifesto predefinito nel file di tipo PE.

Esempio

Nell'esempio seguente viene illustrato il manifesto predefinito che il compilatore di Visual C# inserisce in un file PE.

Nota:

Il compilatore inserisce un nome standard dell'applicazione "MyApplication.app" nell'xml. Si tratta di una soluzione alternativa per consentire alle applicazioni di essere eseguite in Windows Server 2003 Service Pack 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>

Vedere anche

Riferimenti

/nowin32manifest (Nessun manifesto Win32) (Opzioni del compilatore C#)

Altre risorse

Opzioni del compilatore C#

Proprietà del progetto (Visual Studio)