Strumento Visualizzazione autorizzazioni (Permview.exe)

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

Riferimenti

Strumenti di .NET Framework

Concetti

Richiesta di autorizzazioni
Protezione dichiarativa
Pretese
Utilizzo del metodo Assert
Utilizzo del metodo Deny
Utilizzo del metodo PermitOnly

Altre risorse

Assembly in Common Language Runtime