HttpServerUtility.MapPath(String) Método

Definição

Devolve o caminho físico do ficheiro que corresponde ao caminho virtual especificado.

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

O caminho virtual na aplicação Web.

Devoluções

O caminho físico do ficheiro no servidor Web que corresponde a path.

Exceções

A corrente HttpContext é null.

-ou-

path é um caminho físico, mas esperava-se um caminho virtual.

Exemplos

O exemplo seguinte mostra como recuperar o ficheiro físico de um caminho virtual relativo. O código reside no ficheiro code-behind de uma página web e utiliza o objeto predefinido Server .

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

O exemplo seguinte é semelhante ao anterior, exceto que mostra como recuperar um caminho físico dentro de uma classe que não está no ficheiro code-behind.

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

Observações

Se path for null, o MapPath método retorna o caminho físico completo do diretório que contém o pedido atual para o caminho. O caminho relativo não precisa de especificar um ficheiro ou pasta existente para que este método devolva um valor. No entanto, não pode especificar um caminho fora da aplicação Web.

Importante

O MapPath método pode conter informações sensíveis sobre o ambiente de alojamento. O valor de devolução não deve ser apresentado aos utilizadores.

Uma aplicação Web que reside em C:\ExampleSites\TestMapPath devolveria os seguintes resultados:

Pedido de path Valor devolvido
RootLevelPage.aspx null C:\ExemploSites\TestMapPath
RootLevelPage.aspx "/DownOneLevel/DownLevelPage.aspx" C:\ExemploSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspx "/NotRealFolder" C:\ExemploSites\TestMapPath\NotRealFolder
RootLevelPage.aspx ".. /OutsideApplication" HttpException
/DownOneLevel/DownLevelPage.aspx null C:\ExemploSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx ".. /RootLevelPage.aspx" C:\ExemploSites\TestMapPath\RootLevelPage.aspx

Aplica-se a