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

Definição

Retorna o caminho de arquivo físico que corresponde ao caminho virtual especificado.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

O caminho virtual do aplicativo Web.The virtual path in the Web application.

Retornos

O caminho de arquivo físico no servidor Web que corresponde a path.The physical file path on the Web server that corresponds to path.

Exceções

O HttpContext atual é null.The current HttpContext is null.

- ou --or- path é um caminho físico, mas era esperado um caminho virtual.path is a physical path, but a virtual path was expected.

Exemplos

O exemplo a seguir mostra como recuperar o arquivo físico de um caminho virtual relativo.The following example shows how to retrieve the physical file of a relative virtual path. O código reside no arquivo code-behind de uma página da Web e utiliza o objeto padrão 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

O exemplo a seguir é semelhante ao exemplo anterior, exceto que ele mostra como recuperar um caminho físico de dentro de uma classe que não está no arquivo code-behind.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

Comentários

Se path for null, oMapPath método retornará o caminho físico completo do diretório que contém a solicitação atual para o caminho.If path is null, the MapPath method returns the full physical path of the directory that contains the current request for the path. O caminho relativo não precisa especificar um arquivo ou pasta existente para que esse método retorne um valor.The relative path does not need to specify an existing file or folder for this method to return a value. No entanto, você não pode especificar um caminho fora do aplicativo Web.However, you cannot specify a path outside of the Web application.

Importante

O MapPath método potencialmente contém informações confidenciais sobre o ambiente de hospedagem.The MapPath method potentially contains sensitive information about the hosting environment. O valor de retorno não deve ser exibido aos usuários.The return value should not be displayed to users.

Um aplicativo Web que reside em C:\ExampleSites\TestMapPath retorna os seguintes resultados:A Web application that resides at C:\ExampleSites\TestMapPath would return the following results:

Solicitação deRequest from path Valor retornadoReturned 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

Aplica-se a