Partager via


/win32manifest (Options du compilateur C#)

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." Celui-ci crée le manifeste dans le même dossier dans lequel le fichier exécutable est généré, en général le dossier bin\Debug ou bin\Release lorsque vous utilisez Visual Studio. Si vous souhaitez fournir un manifeste personnalisé, par exemple pour spécifier un niveau d'exécution demandé le plus élevé ou demander un administrateur, utilisez cette option pour spécifier le nom du fichier.

[!REMARQUE]

Cette option et l'option /win32res (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 build se produira.

Une application sans manifeste d'application pour spécifier le niveau d'exécution requis est 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 (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

Tâches

Comment : modifier des propriétés de projet et des paramètres de configuration

Référence

/nowin32manifest (Options du compilateur C#)

Autres ressources

Options du compilateur C#