HttpServerUtility.MapPath(String) Método

Definição

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

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

Aplica-se a