HttpServerUtility.MapPath(String) Método

Definição

Namespace:

System.Web

Assembly:

System.Web.dll

Retorna o caminho de arquivo físico 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 do aplicativo Web.

Retornos

String

O caminho de arquivo físico no servidor Web que corresponde a path.

Exceções

HttpException

O HttpContext atual é null.

- ou - path é um caminho físico, mas era esperado um caminho virtual.

Exemplos

O exemplo a seguir mostra como recuperar o arquivo físico de um caminho virtual relativo. O código reside no arquivo code-behind de uma página da Web e utiliza o objeto padrão 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 próximo exemplo é semelhante ao exemplo anterior, exceto que mostra como recuperar um caminho físico de dentro de uma classe que não está no arquivo 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

Comentários

Se path for null, o MapPath método retorna o caminho físico completo do diretório que contém a solicitação atual para o caminho. O caminho relativo não precisa especificar um arquivo ou pasta existente para que esse método retorne um valor. No entanto, você não pode especificar um caminho fora do aplicativo Web.

Importante

O MapPath método potencialmente contém informações confidenciais sobre o ambiente de hospedagem. O valor retornado não deve ser exibido aos usuários.

Um aplicativo Web no qual reside retornaria os seguintes C:\ExampleSites\TestMapPath resultados:

Solicitação de	path	Valor retornado
RootLevelPage.aspx	null	C:\ExampleSites\TestMapPath
RootLevelPage.aspx	"/DownOneLevel/DownLevelPage.aspx"	C:\ExampleSites\TestMapPath\DownOneLevel\DownLevelPage.aspx
RootLevelPage.aspx	"/NotRealFolder"	C:\ExampleSites\TestMapPath\NotRealFolder
RootLevelPage.aspx	".. /OutsideApplication"	HttpException
/DownOneLevel/DownLevelPage.aspx	null	C:\ExampleSites\TestMapPath\DownOneLevel
/DownOneLevel/DownLevelPage.aspx	".. /RootLevelPage.aspx"	C:\ExampleSites\TestMapPath\RootLevelPage.aspx