Strumento Visualizzazione autorizzazioni (Permview.exe)

Aggiornamento: novembre 2007

Lo strumento Visualizzazione autorizzazioni viene utilizzato per visualizzare i set di autorizzazioni minime, facoltative e rifiutate richieste da un assembly. È anche possibile ricorrere a questo strumento per visualizzare tutta la protezione dichiarativa utilizzata da un assembly. Permview.exe è disponibile solo nelle versioni 1.0 e 1.1 di .NET Framework.

permview [/output filename] [/decl] manifestfile

Parametri

Argomento

Descrizione

filemanifesto

Il file contenente il manifesto dell'assembly. Il manifesto può essere un file autonomo oppure incorporato in un file eseguibile portabile (PE, Portable Executable). L'estensione di questo file è in genere EXE o DLL, ma in alcuni casi anche SCR, OR o OCX.

Opzione

Descrizione

/decl

Visualizza tutta la protezione dichiarativa a livello di assembly, di classe e di metodo per l'assembly specificato da filemanifesto. Sono incluse le richieste di autorizzazione nonché le richieste, le asserzioni e le altre operazioni di protezione applicabili in modo dichiarativo. Non fa riferimento ad altri assembly collegati all'assembly specificato.

/h[elp]

Visualizza la sintassi e le opzioni dei comandi dello strumento.

/output nomefile

Scrive l'output nel file specificato. L'impostazione predefinita prevede la visualizzazione dell'output sulla console.

/?

Visualizza la sintassi e le opzioni dei comandi dello strumento.

Note

Gli sviluppatori possono utilizzare Permview.exe per verificare di aver applicato correttamente al codice le richieste di autorizzazione. Gli utenti possono inoltre eseguire Permview.exe per determinare le autorizzazioni che un assembly richiede per poter essere eseguito. Se ad esempio si avvia un eseguibile gestito e viene visualizzato l'errore "System.Security.Policy.PolicyException: Impossibile acquisire i permessi richiesti", sarà possibile utilizzare Permview.exe per determinare le autorizzazioni che il codice dell'eseguibile deve ricevere prima della relativa esecuzione.

Esempi

Il comando che segue visualizza sulla console le autorizzazioni richieste dall'assembly myAssembly.exe.

permview myAssembly.exe

Se myAssembly.exe contiene una richiesta minima di FullTrust, verrà visualizzato l'output che segue.

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

Il comando che segue visualizza sulla console la protezione dichiarativa completa dell'assembly myAssembly.exe. Viene visualizzata la richiesta di protezione a livello di metodo.

permview /decl myAssembly.exe

Verrà visualizzato l'output riportato di seguito.

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>

Il comando che segue scrive le autorizzazioni richieste dall'assembly myAssembly.exe nel file myOutputFile.

permview /output myOutputFile myAssembly.exe 

Vedere anche

Concetti

Richiesta di autorizzazioni

Protezione dichiarativa

Pretese

Utilizzo del metodo Assert

Utilizzo del metodo Deny

Utilizzo del metodo PermitOnly

Riferimenti

Strumenti di .NET Framework

Altre risorse

Assembly in Common Language Runtime