HttpRequest.MapPath Metode

Definisi

Ruang nama:: System.Web

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Memetakan jalur virtual di URL yang diminta ke jalur fisik di server untuk permintaan saat ini.

Overload

Nama	Deskripsi
MapPath(String)	Memetakan jalur virtual yang ditentukan ke jalur fisik.
MapPath(String, String, Boolean)	Memetakan jalur virtual yang ditentukan ke jalur fisik.

MapPath(String)

Memetakan jalur virtual yang ditentukan ke jalur fisik.

public:
 System::String ^ MapPath(System::String ^ virtualPath);

public string MapPath(string virtualPath);

member this.MapPath : string -> string

Public Function MapPath (virtualPath As String) As String

Parameter

virtualPath: String

Jalur virtual (absolut atau relatif) untuk permintaan saat ini.

Mengembalikan

String

Jalur fisik pada server yang ditentukan oleh virtualPath.

Pengecualian

HttpException

Tidak ada HttpContext objek yang didefinisikan untuk permintaan.

Contoh

Contoh kode berikut menggunakan MapPath metode untuk mengonversi jalur virtual ke jalur fisik yang sepenuhnya memenuhi syarat di server. Contoh ini memiliki dua bagian:

Halaman .aspx memetakan jalur, membaca file, dan menampilkan hasil operasi baca.
Kelas, UpperCaseFilterStream, yang mengubah semua karakter yang melewatinya menjadi huruf besar.

Bagian pertama dari contoh menunjukkan cara mengonversi jalur virtual ke jalur fisik yang sepenuhnya memenuhi syarat menggunakan metode .MapPath Jalur fisik ini kemudian diteruskan ke StreamReader objek, yang mendapatkan konten file. Metode Write ini kemudian dipanggil untuk menampilkan konten file di halaman. Properti Filter digunakan untuk melampirkan filter ke aliran respons yang membuat teks ditampilkan ke halaman semua huruf besar.

<%@ Page Language="C#" %>
<%@ Import Namespace="System.IO" %>
<%@ import Namespace="Samples.AspNet.CS.Controls"  %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    private void Page_Load(object sender, EventArgs e)
    {

      // Filter the text to be rendered as all uppercase.
      Response.Filter = new UpperCaseFilterStream(Response.Filter);

      // Convert a virtual path to a fully qualified physical path.
      string fullpath = Request.MapPath("~\\TestFile.txt");

      try
      {
        // Read the contents of the file using a StreamReader.
        using (StreamReader sr = new StreamReader(fullpath))
        while (sr.Peek() >= 0)
        {
          Response.Write((char)sr.Read());
        }
        Message.Text = "Reading the file was successful.";
        
      }
      catch (Exception ex)
      {
        Message.Text = "The process failed.";
      }    
     }

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>HttpResponse.MapPath Example</title>
  </head>
  <body>
    <form id="form1" runat="server">

      <asp:Label id="Message" 
                 runat="server"/>

    </form>
  </body>
</html>

<%@ Page Language="VB" Debug="true"%>
<%@ Import Namespace="System.IO" %>
<%@ Import Namespace="Samples.AspNet.VB.Controls" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
     
  Private Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
      
    ' Filter the text to be rendered as all uppercase.
    Response.Filter = New UpperCaseFilterStream(Response.Filter)
    
    ' Convert a virtual path to a fully qualified physical path.
    Dim fullpath As String = Request.MapPath("~\\TestFile.txt")
    
    Try
      
      Dim sr As StreamReader = New StreamReader(fullpath)
      
      Do While sr.Peek() >= 0
        Response.Write(Convert.ToChar(sr.Read()))
      Loop
      sr.Close()
      Message.Text = "Reading the file was successful."
      
    Catch ex As Exception
      
      Message.Text = "The process failed."

    End Try

    
  End Sub

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>HttpResponse.MapPath Example</title>
  </head>
  <body>
    <form id="Form1" runat="server">

      <asp:Label id="Message" 
                 runat="server"/>

    </form>
  </body>
</html>

Bagian kedua dari contoh menunjukkan kelas yang mewarisi dan Stream mengonversi semua karakter dalam aliran menjadi huruf besar. Masukkan kode ini ke App_Code dalam folder untuk aplikasi Anda.


using System;
using System.IO;
using System.Text;

namespace Samples.AspNet.CS.Controls
{

   public class UpperCaseFilterStream : Stream
   // This filter changes all characters passed through it to uppercase.
   {
      private Stream strSink;
      private long lngPosition;

      public UpperCaseFilterStream(Stream sink)
      {
          strSink = sink;
      }

      // The following members of Stream must be overriden.
      public override bool CanRead
      {
         get { return true; }
      }

      public override bool CanSeek
      {
         get { return true; }
      }

      public override bool CanWrite
      {
         get { return true; }
      }

      public override long Length
      {
         get { return 0; }
      }

      public override long Position
      {
         get { return lngPosition; }
         set { lngPosition = value; }
      }

      public override long Seek(long offset, System.IO.SeekOrigin direction)
      {
         return strSink.Seek(offset, direction);
      }

      public override void SetLength(long length)
      {
         strSink.SetLength(length);
      }

      public override void Close()
      {
         strSink.Close();
      }

      public override void Flush()
      {
         strSink.Flush();
      }

      public override int Read(byte[] buffer, int offset, int count)
      {
         return strSink.Read(buffer, offset, count);
      }

      // The Write method actually does the filtering.
      public override void Write(byte[] buffer, int offset, int count)
      {
         byte[] data = new byte[count];
         Buffer.BlockCopy(buffer, offset, data, 0, count);
         string inputstring = Encoding.ASCII.GetString(data).ToUpper();
         data = Encoding.ASCII.GetBytes(inputstring);
         strSink.Write(data, 0, count);
      }
   }
}

Imports System.IO
Imports System.Text


Namespace Samples.AspNet.VB.Controls

    Public Class UpperCaseFilterStream
        Inherits Stream

        ' This filter changes all characters passed through it to uppercase.
        Private strSink As Stream
        Private lngPosition As Long


        Public Sub New(ByVal sink As Stream)
            strSink = sink
        End Sub

        ' The following members of Stream must be overriden.  
        Public Overrides ReadOnly Property CanRead() As Boolean
            Get
                Return True
            End Get
        End Property

        Public Overrides ReadOnly Property CanSeek() As Boolean
            Get
                Return True
            End Get
        End Property

        Public Overrides ReadOnly Property CanWrite() As Boolean
            Get
                Return True
            End Get
        End Property

        Public Overrides ReadOnly Property Length() As Long
            Get
                Return 0
            End Get
        End Property

        Public Overrides Property Position() As Long
            Get
                Return lngPosition
            End Get
            Set(ByVal value As Long)
                lngPosition = Value
            End Set
        End Property

        Public Overrides Function Seek( _
        ByVal offset As Long, ByVal direction As System.IO.SeekOrigin) As Long
            Return strSink.Seek(offset, direction)
        End Function 'Seek


        Public Overrides Sub SetLength(ByVal length As Long)
            strSink.SetLength(length)
        End Sub


        Public Overrides Sub Close()
            strSink.Close()
        End Sub


        Public Overrides Sub Flush()
            strSink.Flush()
        End Sub


        Public Overrides Function Read( _
        ByVal buffer() As Byte, ByVal offset As Integer, ByVal count As Integer) As Integer
            Return strSink.Read(buffer, offset, count)
        End Function 'Read


        ' The Write method actually does the filtering.
        Public Overrides Sub Write( _
        ByVal buffer() As Byte, ByVal offset As Integer, ByVal count As Integer)

            Dim data(count) As Byte
            System.Buffer.BlockCopy(buffer, offset, data, 0, count)
            Dim inputstring As String = Encoding.ASCII.GetString(data).ToUpper()
            data = Encoding.ASCII.GetBytes(InputString)
            strSink.Write(data, 0, count)

        End Sub

    End Class

End Namespace

Keterangan

Perhatian

Metode ini MapPath berpotensi berisi informasi sensitif tentang lingkungan hosting. Nilai pengembalian tidak boleh ditampilkan kepada pengguna.

Berlaku untuk

MapPath(String, String, Boolean)

Memetakan jalur virtual yang ditentukan ke jalur fisik.

public:
 System::String ^ MapPath(System::String ^ virtualPath, System::String ^ baseVirtualDir, bool allowCrossAppMapping);

public string MapPath(string virtualPath, string baseVirtualDir, bool allowCrossAppMapping);

member this.MapPath : string * string * bool -> string

Public Function MapPath (virtualPath As String, baseVirtualDir As String, allowCrossAppMapping As Boolean) As String

Parameter

virtualPath: String

Jalur virtual (absolut atau relatif) untuk permintaan saat ini.

baseVirtualDir: String

Jalur direktori dasar virtual yang digunakan untuk resolusi relatif.

allowCrossAppMapping: Boolean

true untuk menunjukkan bahwa virtualPath mungkin milik aplikasi lain; jika tidak, false.

Mengembalikan

String

Jalur fisik di server.

Pengecualian

HttpException

allowCrossMapping adalah false dan virtualPath milik aplikasi lain.

-atau-

Tidak ada HttpContext objek yang didefinisikan untuk permintaan.

Keterangan

Perhatian

Metode ini MapPath berpotensi berisi informasi sensitif tentang lingkungan hosting. Nilai pengembalian tidak boleh ditampilkan kepada pengguna.

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?

Bagikan melalui

HttpRequest.MapPath Metode

Definisi

Overload

MapPath(String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Berlaku untuk

MapPath(String, String, Boolean)

Parameter

Mengembalikan

Pengecualian

Keterangan

Berlaku untuk

Saran dan Komentar