HttpRequest.MapPath Metódus

Definíció

Névtér:: System.Web

Szerelvény:: System.Web.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

A kért URL-címben lévő virtuális elérési utat az aktuális kéréshez tartozó fizikai elérési útra képezi le a kiszolgálón.

Túlterhelések

Name	Description
MapPath(String)	A megadott virtuális elérési utat egy fizikai útvonalra képezi le.
MapPath(String, String, Boolean)	A megadott virtuális elérési utat egy fizikai útvonalra képezi le.

MapPath(String)

A megadott virtuális elérési utat egy fizikai útvonalra képezi le.

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

Paraméterek

virtualPath: String

Az aktuális kérés virtuális elérési útja (abszolút vagy relatív).

Válaszok

String

A kiszolgálón megadott virtualPathfizikai elérési út.

Kivételek

HttpException

A kéréshez nincs HttpContext definiálva objektum.

Példák

Az alábbi példakód egy virtuális elérési út teljes fizikai elérési úttá alakításához használja a MapPath metódust a kiszolgálón. Ez a példa két részből áll:

Egy .aspx oldal leképezi az elérési utat, beolvassa a fájlt, és megjeleníti az olvasási művelet eredményeit.
Egy osztály, UpperCaseFilterStreamamely a rajta áthaladó összes karaktert nagybetűsre módosítja.

A példa első része bemutatja, hogyan alakíthat át egy virtuális elérési utat teljesen minősített fizikai elérési úttá a MapPath metódus használatával. Ez a fizikai elérési út ezután egy StreamReader objektumnak lesz átadva, amely beolvasja a fájl tartalmát. Ezután Write a rendszer meghívja a metódust, hogy megjelenítse a fájl tartalmát a lapon. A Filter tulajdonság egy szűrő csatolására szolgál a válaszfolyamhoz, amely nagybetűssé teszi a lapon megjelenített szöveget.

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

A példa második része egy olyan osztályt mutat be, amely egy stream összes karakterét Stream nagybetűssé alakítja. Helyezze ezt a kódot az App_Code alkalmazás mappájába.


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

Megjegyzések

Figyelmeztetés

A MapPath metódus potenciálisan bizalmas információkat tartalmaz az üzemeltetési környezetről. A visszatérési érték nem jeleníthető meg a felhasználók számára.

A következőre érvényes:

MapPath(String, String, Boolean)

A megadott virtuális elérési utat egy fizikai útvonalra képezi le.

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

Paraméterek

virtualPath: String

Az aktuális kérés virtuális elérési útja (abszolút vagy relatív).

baseVirtualDir: String

A relatív felbontáshoz használt virtuális alapkönyvtár elérési útja.

allowCrossAppMapping: Boolean

true annak jelzésére, hogy virtualPath az egy másik alkalmazáshoz tartozhat; falseellenkező esetben.

Válaszok

String

A kiszolgálón lévő fizikai elérési út.

Kivételek

HttpException

allowCrossMapping false egy virtualPath másik alkalmazáshoz tartozik.

-vagy-

A kéréshez nincs HttpContext definiálva objektum.

Megjegyzések

Figyelmeztetés

A MapPath metódus potenciálisan bizalmas információkat tartalmaz az üzemeltetési környezetről. A visszatérési érték nem jeleníthető meg a felhasználók számára.

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?