/win32manifest (Importer un fichier manifeste Win32 personnalisé) (Options du compilateur C#)

Article
08/21/2008

Mise à jour : novembre 2007

Utilisez l'option /win32manifest pour spécifier le fichier manifeste d'application Win32 défini par l'utilisateur à inclure dans le fichier exécutable portable (PE) d'un projet.

/win32manifest: filename

Arguments

filename
Les nom et emplacement du fichier manifeste personnalisé.

Notes

Par défaut, le compilateur Visual C# inclut un manifeste d'application qui spécifie le niveau d'exécution requis "asInvoker." Il crée le manifeste dans le dossier de génération du fichier exécutable, généralement le dossier bin\Debug ou bin\Release lorsque vous utilisez Visual Studio. Pour fournir un manifeste personnalisé, par exemple pour spécifier le niveau d'exécution demandé « highestAvailable » ou « requireAdministrator », utilisez cette option pour indiquer le nom du fichier.

Remarque :
Cette option et l'option /win32res (Importer un fichier de ressources Win32) (Options du compilateur C#) sont mutuellement exclusives. Si vous tentez d'utiliser ces deux options dans la même ligne de commande, une erreur de génération se produira.

Une application sans manifeste d'application pour spécifier le niveau d'exécution requis sera soumise à une virtualisation des fichiers/registres sous la fonction de contrôle de compte utilisateur de Windows Vista. Pour plus d'informations sur la virtualisation, consultez The Windows Vista Developer Story: Windows Vista Application Development Requirements for User Account Control (UAC).

Votre application sera soumise à virtualisation si l'une de ces conditions est vérifiée :

Vous utilisez l'option /nowin32manifest sans fournir de manifeste au cours d'une étape de génération ultérieure ou en tant que partie du fichier de ressources Windows (.res) à l'aide de l'option /win32res.
Vous fournissez un manifeste personnalisé qui ne spécifie pas le niveau d'exécution requis.

Visual Studio crée un fichier .manifest par défaut et le stocke dans les répertoires debug et release avec le fichier exécutable. Vous pouvez ajouter un manifeste personnalisé en en créant un dans un éditeur de texte et en ajoutant le fichier au projet. Vous pouvez également cliquer avec le bouton droit sur l'icône Projet de l'Explorateur de solutions, cliquer sur Ajouter un nouvel élément, puis sur Fichier manifeste d'application. Une fois que vous avez ajouté votre fichier manifeste nouveau ou existant, il apparaît dans la liste déroulante Manifeste. Pour plus d'informations, consultez Page Application, Concepteur de projets (C#).

Vous pouvez fournir le manifeste d'application en tant qu'étape après génération personnalisée ou en tant que partie d'un fichier de ressources Win32 à l'aide de l'option /nowin32manifest (Aucun manifeste Win32) (Options du compilateur C#). Utilisez cette même option pour que votre application soit soumise à la virtualisation des fichiers ou des registres dans Windows Vista. Cela empêche le compilateur de créer et d'inclure un manifeste par défaut dans le fichier exécutable portable (PE).

Exemple

L'exemple suivant présente le manifeste par défaut que le compilateur Visual C# insère dans un PE.

Remarque :
Le compilateur insère un nom d'application standard " MyApplication.app " au fichier xml. Cela permet aux applications de s'exécuter sous 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>

Voir aussi

Référence

/nowin32manifest (Aucun manifeste Win32) (Options du compilateur C#)

Autres ressources

Options du compilateur C#

Propriétés de projet (Visual Studio)

Partager via