HttpServerUtility.MapPath(String) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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 |