HttpRequest.MapPath Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Mapy ścieżkę wirtualną w żądanym adresie URL do ścieżki fizycznej na serwerze dla bieżącego żądania.

Przeciążenia

MapPath(String)	Mapy określoną ścieżkę wirtualną do ścieżki fizycznej.
MapPath(String, String, Boolean)	Mapy określoną ścieżkę wirtualną do ścieżki fizycznej.

MapPath(String)

Mapy określoną ścieżkę wirtualną do ścieżki fizycznej.

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

Parametry

virtualPath: String

Ścieżka wirtualna (bezwzględna lub względna) dla bieżącego żądania.

Zwraca

String

Ścieżka fizyczna na serwerze określonym przez virtualPath.

Wyjątki

HttpException

Dla żądania nie HttpContext zdefiniowano żadnego obiektu.

Przykłady

W poniższym przykładzie kodu użyto MapPath metody , aby przekonwertować ścieżkę wirtualną na w pełni kwalifikowaną ścieżkę fizyczną na serwerze. Ten przykład ma dwie części:

Strona aspx mapuje ścieżkę, odczytuje plik i wyświetla wyniki operacji odczytu.
Klasa , UpperCaseFilterStreamktóra zmienia wszystkie znaki przekazywane przez nią na wielkie litery.

Pierwsza część przykładu pokazuje, jak przekonwertować ścieżkę wirtualną na w pełni kwalifikowaną ścieżkę fizyczną przy użyciu MapPath metody . Ta ścieżka fizyczna jest następnie przekazywana do StreamReader obiektu, który uzyskuje zawartość pliku. Metoda Write jest następnie wywoływana w celu wyświetlenia zawartości pliku na stronie. Właściwość Filter służy do dołączania filtru do strumienia odpowiedzi, który sprawia, że tekst jest wyświetlany na stronie wszystkie wielkie litery.

<%@ 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>

Druga część przykładu przedstawia klasę dziedziczą Stream i konwertują wszystkie znaki w strumieniu na wielkie litery. Umieść ten kod w folderze App_Code aplikacji.


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

Uwagi

Przestroga

Właściwość MapPath potencjalnie zawiera poufne informacje o środowisku hostingu. Wartość zwracana nie powinna być wyświetlana użytkownikom.

Dotyczy

MapPath(String, String, Boolean)

Mapy określoną ścieżkę wirtualną do ścieżki fizycznej.

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

Parametry

virtualPath: String

Ścieżka wirtualna (bezwzględna lub względna) dla bieżącego żądania.

baseVirtualDir: String

Ścieżka katalogu wirtualnego podstawowego używana do względnego rozpoznawania.

allowCrossAppMapping: Boolean

true, aby wskazać, że virtualPath może należeć do innej aplikacji; w przeciwnym razie . false

Zwraca

String

Ścieżka fizyczna na serwerze.

Wyjątki

HttpException

allowCrossMapping jest false i virtualPath należy do innej aplikacji.

-lub-

Dla żądania nie HttpContext zdefiniowano żadnego obiektu.

Uwagi

Przestroga

Właściwość MapPath potencjalnie zawiera poufne informacje o środowisku hostingu. Wartość zwracana nie powinna być wyświetlana użytkownikom.

Dotyczy

Udostępnij za pośrednictwem

HttpRequest.MapPath Metoda

Definicja

Przeciążenia

MapPath(String)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Dotyczy

MapPath(String, String, Boolean)

Parametry

Zwraca

Wyjątki

Uwagi

Dotyczy

Dodatkowe zasoby