-win32manifest (Visual Basic)

  • Articolo

Identifica un file manifesto dell'applicazione Win32 definito dall'utente da incorporare nel file eseguibile di tipo PE di un progetto.

Sintassi

-win32manifest: fileName

Argomenti

Termine Definizione
fileName Percorso del file manifesto personalizzato.

Osservazioni:

Per impostazione predefinita, il compilatore Visual Basic incorpora un manifesto dell'applicazione che specifica il livello di esecuzione richiesto "asInvoker". Viene creato il manifesto nella stessa cartella in cui viene compilato il file eseguibile, in genere la cartella bin\Debug o bin\Release quando si usa Visual Studio. Per specificare un manifesto personalizzato, ad esempio un livello di esecuzione richiesto "highestAvailable" o "requireAdministrator", usare questa opzione per indicare il nome del file.

Nota

Questa opzione e l'opzione -win32resource si escludono a vicenda. Se si tenta di usare entrambe le opzioni nella stessa riga di comando si otterrà un errore di compilazione.

Un'applicazione senza un manifesto dell'applicazione che specifica un livello di esecuzione richiesto sarà soggetta alla virtualizzazione dei file e del Registro di sistema con la funzionalità Controllo account utente in Windows Vista. Per altre informazioni sulla virtualizzazione, vedere Distribuzione ClickOnce in Windows Vista.

L'applicazione sarà sottoposta a virtualizzazione se una delle condizioni seguenti è vera:

  1. Si usa l'opzione -nowin32manifest e non si specifica un manifesto in un passaggio di compilazione successivo o come parte di un file di risorse di Windows (.res) usando l'opzione -win32resource.

  2. Si indica un manifesto personalizzato che non specifica un livello di esecuzione richiesto.

Visual Studio crea un file .manifest predefinito e lo archivia nelle directory di debug e versione insieme al file eseguibile. È possibile visualizzare o modificare il file app.manifest predefinito facendo clic su Visualizza impostazioni di controllo dell'account utente nella scheda Applicazione in Progettazione progetti. Per altre informazioni, vedere Pagina Applicazione, Creazione progetti (Visual Basic).

È possibile inserire il manifesto dell'applicazione come fase personalizzata dopo la compilazione o come parte di un file di risorse Win32 usando l'opzione -nowin32manifest. Usare la stessa opzione se si vuole che l'applicazione sia sottoposta alla virtualizzazione dei file o del Registro di sistema in Windows Vista. Ciò impedirà al compilatore di creare e incorporare un manifesto predefinito nel file di tipo PE.

Esempio

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

Nota

Il compilatore inserisce un nome di applicazione standard "MyApplication.app" nel file XML manifesto. Si tratta di una soluzione alternativa per consentire l'esecuzione delle applicazioni 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>

Vedi anche