Metodo Control.MapPathSecure (System.Web.UI)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Metodo Control.MapPathSecure
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Recupera il percorso fisico al quale è associato un percorso virtuale, assoluto o relativo.

Spazio dei nomi:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
Sintassi

Visual Basic
Protected Friend Function MapPathSecure ( _
	virtualPath As String _
) As String
C#
protected internal string MapPathSecure(
	string virtualPath
)
Visual C++
protected public:
String^ MapPathSecure(
	String^ virtualPath
)
F#
member MapPathSecure : 
        virtualPath:string -> string 

Parametri

virtualPath
Tipo: System.String
URL relativo o relativo alla directory radice.

Valore restituito

Tipo: System.String
Percorso fisico al file richiesto.
Eccezioni

Eccezione Condizione
ArgumentNullException

Il valore di virtualPath è null oppure una stringa vuota ("").

Note

Il metodo può essere utilizzato solo dai controlli server che dispongono delle autorizzazioni per la lettura di file e che sono parte di file DLL completamente attendibili, come System.Web.dll. Contribuisce a impedire violazioni della sicurezza.

Esempi

Nell'esempio che segue viene utilizzato il metodo MapPathSecure per ottenere il percorso fisico di una directory virtuale dell'oggetto contenitore Page oppure UserControl.

Visual Basic

' An HttpException occurs if the server control does not,;
' have permissions to read the resulting mapped file.
output.Write("The Actual Path of the virtual directory : " & _
            MapPathSecure(TemplateSourceDirectory) & "<br>")

' Get all the files from the absolute path of 'MyControl';
' using TemplateSourceDirectory which gives the virtual Directory.
Dim myFiles As String() = Directory.GetFiles(MapPathSecure(TemplateSourceDirectory))
output.Write("The files in this Directory are <br>")

' List all the files.
Dim i As Integer
For i = 0 To myFiles.Length - 1
   output.Write(myFiles(i) & "<br>")
Next i


C#

// An HttpException occurs if the server control does not,;
// have permissions to read the resulting mapped file. 
     output.Write("The Actual Path of the virtual directory : "+
     MapPathSecure(TemplateSourceDirectory)+"<br>");

    // Get all the files from the absolute path of 'MyControl';
    // using TemplateSourceDirectory which gives the virtual Directory.
        string [] myFiles=
        Directory.GetFiles(MapPathSecure(TemplateSourceDirectory));
        output.Write("The files in this Directory are <br>");

         // List all the files.
         for (int i=0;i<myFiles.Length;i++)
            output.Write(myFiles[i]+"<br>");


Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Vedere anche

Riferimenti