Outil Permissions View Tool (Permview.exe)
Mise à jour : novembre 2007
L'outil Permissions View Tool permet d'afficher les jeux d'autorisations minimales, facultatives et refusées demandés par un assembly. Vous pouvez également utiliser Permview.exe pour afficher toutes les sécurités déclaratives utilisées par un assembly. Permview.exe est uniquement disponible dans les versions 1.0 et 1.1 de .NET Framework.
permview [/output filename] [/decl] manifestfile
Paramètres
Argument |
Description |
|---|---|
manifestfile |
Fichier comportant le manifeste de l'assembly. Le manifeste peut soit correspondre à un fichier autonome, soit être incorporé à un fichier exécutable portable. L'extension de ce fichier est généralement .exe ou .dll, mais elle peut également être .scr ou .ocx. |
Option |
Description |
|---|---|
/decl |
Affiche toutes les sécurités déclaratives au niveau de l'assembly, de la classe et de la méthode de l'assembly spécifié par manifestfile. Cela inclut les demandes d'autorisations, ainsi que les demandes, les assertions et toutes les autres actions de sécurité pouvant être appliquées d'une manière déclarative. Il n'est pas fait référence à d'autres assemblys liés à l'assembly spécifié. |
/h[elp] |
Affiche la syntaxe et les options de commande de l'outil. |
/output filename |
Écrit les résultats dans le fichier spécifié. L'affichage des résultats s'effectue par défaut dans la console. |
/? |
Affiche la syntaxe et les options de commande de l'outil. |
Notes
Les développeurs peuvent utiliser Permview.exe pour vérifier qu'ils ont correctement appliqué les demandes d'autorisations à leur code. Les utilisateurs peuvent également exécuter Permview.exe pour déterminer les autorisations qu'un assembly doit exécuter. Par exemple, si vous exécutez un exécutable managé et obtenez le message d'erreur « System.Security.Policy.PolicyException : Impossible d'acquérir les autorisations requises », vous pouvez utiliser Permview.exe pour déterminer les autorisations que le code figurant dans votre exécutable doit recevoir avant son exécution.
Exemples
La commande suivante affiche les autorisations demandées par l'assembly myAssembly.exe dans la console.
permview myAssembly.exe
Si myAssembly.exe comporte une demande d'autorisation minimale pour FullTrust, les résultats suivants s'affichent.
Microsoft (R) .NET Framework Permission Request Viewer. Version 1.0.2204.18 Copyright (C) Microsoft Corp. 1998-2000
minimal permission set:
<PermissionSet class="System.Security.PermissionSet" version ="1">
<Unrestricted/>
</PermissionSet>
optional permission set:
Not specified
refused permission set:
Not specified
La commande suivante affiche toutes les sécurités déclaratives de l'assembly myAssembly.exe dans la console. Cette commande affiche la demande de sécurité au niveau de la méthode.
permview /decl myAssembly.exe
Les résultats suivants s'affichent.
Microsoft (R) .NET Framework Permission Request Viewer.
Version 1.0.2204.18 Copyright (C) Microsoft Corp. 1998-2000
Assembly RequestMinimum permission set:
<PermissionSet class="System.Security.PermissionSet" version ="1">
<Unrestricted/>
</PermissionSet>
Method A::myMethod() LinktimeCheck permission set:
<PermissionSet class="System.Security.PermissionSet" version="1">
<Permission class="System.Security.Permissions.ReflectionPermission,
mscorlib, Ver=1.0.2204.2, Loc='', SN=03689116d3a4ae33"
version="1">
<MemberAccess/>
</Permission>
</PermissionSet>
La commande suivante écrit les autorisations demandées par l'assembly myAssembly.exe dans le fichier myOutputFile.
permview /output myOutputFile myAssembly.exe
Voir aussi
Concepts
Utilisation de la méthode Assert
Utilisation de la méthode Deny
Utilisation de la méthode PermitOnly