HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) HttpServerUtility.MapPath(String) Method

Definición

Devuelve la ruta de acceso del archivo físico que corresponde a la ruta de acceso virtual especificada.Returns the physical file path that corresponds to the specified virtual path.

public:
 System::String ^ MapPath(System::String ^ path);
public string MapPath (string path);
member this.MapPath : string -> string
Public Function MapPath (path As String) As String

Parámetros

path
String String String String

Ruta de acceso virtual de la aplicación web.The virtual path in the Web application.

Devoluciones

Ruta de acceso física del archivo en el servidor web correspondiente a path.The physical file path on the Web server that corresponds to path.

Excepciones

El HttpContext actual es null.The current HttpContext is null.

O bien-or- path es una ruta de acceso física, pero se esperaba una ruta de acceso virtual.path is a physical path, but a virtual path was expected.

Ejemplos

En el ejemplo siguiente se muestra cómo recuperar el archivo físico de una ruta de acceso virtual relativa.The following example shows how to retrieve the physical file of a relative virtual path. El código reside en el archivo de código subyacente de una página web y utiliza el objeto predeterminado Server .The code resides in the code-behind file for a web page and utilizes the default Server object.

public partial class _Default : Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        string pathToFiles = Server.MapPath("/UploadedFiles");
    }
}
Public Class _Default
    Inherits Page

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs) Handles Me.Load
        Dim pathToFiles = Server.MapPath("/UploadedFiles")
    End Sub
End Class

El ejemplo siguiente es similar al anterior, salvo que muestra cómo recuperar una ruta de acceso física desde dentro de una clase que no está en el archivo de código subyacente.The next example is similar to the previous example except it shows how to retrieve a physical path from within a class that is not in the code-behind file.

public class SampleClass
{
    public string GetFilePath()
    {
        return HttpContext.Current.Server.MapPath("/UploadedFiles");
    }
}
Public Class SampleClass
    Public Function GetFilePath() As String
        Return HttpContext.Current.Server.MapPath("/UploadedFiles")
    End Function
End Class

Comentarios

Si path es null, elMapPath método devuelve la ruta de acceso física completa del directorio que contiene la solicitud actual para la ruta de acceso.If path is null, the MapPath method returns the full physical path of the directory that contains the current request for the path. La ruta de acceso relativa no necesita especificar un archivo o carpeta existente para que este método devuelva un valor.The relative path does not need to specify an existing file or folder for this method to return a value. Sin embargo, no puede especificar una ruta de acceso fuera de la aplicación Web.However, you cannot specify a path outside of the Web application.

Importante

El MapPath método contiene potencialmente información confidencial sobre el entorno de hospedaje.The MapPath method potentially contains sensitive information about the hosting environment. El valor devuelto no debe mostrarse a los usuarios.The return value should not be displayed to users.

Una aplicación web que resida en C:\ExampleSites\TestMapPath devolverá los resultados siguientes:A Web application that resides at C:\ExampleSites\TestMapPath would return the following results:

Solicitud deRequest from path Valor devueltoReturned value
RootLevelPage.aspxRootLevelPage.aspx null C:\ExampleSites\TestMapPathC:\ExampleSites\TestMapPath
RootLevelPage.aspxRootLevelPage.aspx "/DownOneLevel/DownLevelPage.aspx""/DownOneLevel/DownLevelPage.aspx" C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspxC:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspxRootLevelPage.aspx "/NotRealFolder""/NotRealFolder" C:\ExampleSites\TestMapPath\NotRealFolderC:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage.aspxRootLevelPage.aspx ".. /OutsideApplication""../OutsideApplication" HttpException
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx null C:\ExampleSites\TestMapPath\DownOneLevelC:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx/DownOneLevel/DownLevelPage.aspx "../RootLevelPage.aspx""../RootLevelPage.aspx" C:\ExampleSites\TestMapPath\RootLevelPage.aspxC:\ExampleSites\TestMapPath\RootLevelPage.aspx

Se aplica a