HttpContext.RewritePath Метод

Ссылка

Определение

Пространство имен:: System.Web

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перенаправляет запрос ресурса по пути, отличному от указанного в запрошенном URL-адресе. RewritePath используется в состоянии сеанса без куки-файлов, чтобы отделять ИД сеансов от URL-адресов.

Перегрузки

RewritePath(String, String, String, Boolean)	Перезаписывает URL-адрес, используя заданный виртуальный путь, сведения о пути, данные строки запроса и логическое значение, которое указывает, был ли задан путь к файлу клиента как путь перезаписи.
RewritePath(String, String, String)	Перезаписывает URL-адрес, используя заданный путь, сведения о пути и данные строки запроса.
RewritePath(String, Boolean)	Перезаписывает URL-адрес, используя заданный путь и логическое значение, которое указывает, был ли изменен виртуальный путь к ресурсам сервера.
RewritePath(String)	Перезаписывает URL-адрес, используя заданный путь.

RewritePath(String, String, String, Boolean)

Перезаписывает URL-адрес, используя заданный виртуальный путь, сведения о пути, данные строки запроса и логическое значение, которое указывает, был ли задан путь к файлу клиента как путь перезаписи.

public:
 void RewritePath(System::String ^ filePath, System::String ^ pathInfo, System::String ^ queryString, bool setClientFilePath);

public void RewritePath (string filePath, string pathInfo, string queryString, bool setClientFilePath);

member this.RewritePath : string * string * string * bool -> unit

Public Sub RewritePath (filePath As String, pathInfo As String, queryString As String, setClientFilePath As Boolean)

Параметры

filePath: String

Виртуальный путь к ресурсу, обслуживающему запрос.

pathInfo: String

Дополнительные сведения о пути, используемые для перенаправления URL-адреса. Для получения дополнительной информации см. PathInfo.

queryString: String

Строка запроса, используемая для перенаправления URL-адреса.

setClientFilePath: Boolean

Значение true для присвоения пути к файлу, используемому для ресурсов клиента, значения параметра filePath; в противном случае — значение false.

Исключения

ArgumentNullException

Параметр path отсутствует в корневом каталоге текущего приложения.

HttpException

Параметр filePath отсутствует в корневом каталоге текущего приложения.

Примеры

Пример кода см. в описании перегрузки RewritePath(String) метода.

Параметр filePath не включает содержимое pathInfo параметра. Для URL-адреса http://www.microsoft.com/virdir/page.html/tail``filePath параметр имеет http://www.microsoft.com/virdir/page.htmlзначение , а pathInfo параметр — tail.

Чтобы убедиться, что виртуальный путь, используемый для создания путей к ресурсам, не изменяется, задайте для параметра значение setClientFilePath false. Распространенный сценарий, в котором может потребоваться задать значение setClientFilePath false , заключается в том, когда необходимо переписать URL-адрес, и вы используете темы и перенаправляете URL-адрес в ресурс, расположенный в папке, отличной от запрошенного ресурса.

Перезапись URL-адресов полезна, если вы хотите реструктурировать страницы в веб-приложении, и вы хотите убедиться, что пользователи, которые закладывают старые URL-адреса, по-прежнему могут использовать их после перемещения страниц. Перезапись URL-адресов позволяет прозрачно пересылать запросы в новое расположение страницы.

Если вы хотите разрешить сайту использовать URL-адреса, которые более удобны для пользователей и оптимизированы для поисковых систем, более надежная альтернатива — использовать ASP.NET маршрутизацию. Дополнительные сведения см. в разделе ASP.NET маршрутизации.

См. также раздел

Применяется к

RewritePath(String, String, String)

Перезаписывает URL-адрес, используя заданный путь, сведения о пути и данные строки запроса.

public:
 void RewritePath(System::String ^ filePath, System::String ^ pathInfo, System::String ^ queryString);

public void RewritePath (string filePath, string pathInfo, string queryString);

member this.RewritePath : string * string * string -> unit

Public Sub RewritePath (filePath As String, pathInfo As String, queryString As String)

Параметры

filePath: String

Внутренний путь перезаписи.

pathInfo: String

Дополнительные сведения о пути для ресурса. Для получения дополнительной информации см. PathInfo.

queryString: String

Строка запроса.

Исключения

ArgumentNullException

Параметр path отсутствует в корневом каталоге текущего приложения.

HttpException

Параметр filePath отсутствует в корневом каталоге текущего приложения.

Примеры

Пример кода, включая пример перегрузки этого метода, см. в статье о перегрузке RewritePath(String) метода.

См. также раздел

Применяется к

RewritePath(String, Boolean)

Перезаписывает URL-адрес, используя заданный путь и логическое значение, которое указывает, был ли изменен виртуальный путь к ресурсам сервера.

public:
 void RewritePath(System::String ^ path, bool rebaseClientPath);

public void RewritePath (string path, bool rebaseClientPath);

member this.RewritePath : string * bool -> unit

Public Sub RewritePath (path As String, rebaseClientPath As Boolean)

Параметры

path: String

Внутренний путь перезаписи.

rebaseClientPath: Boolean

Значение true для сброса виртуального пути; значение false для сохранения виртуального пути без изменений.

Исключения

ArgumentNullException

Параметр path имеет значение null.

HttpException

Параметр path отсутствует в корневом каталоге текущего приложения.

Примеры

Пример кода см. в описании перегрузки RewritePath(String) метода.

Метод HttpContext.RewritePath(String, Boolean) вызывается методом с заданным HttpContext.RewritePath(String) параметром rebaseClientPath true. Чтобы убедиться, что виртуальный путь, используемый для создания путей к ресурсам, не изменяется, задайте для параметра значение rebaseClientPath false. Распространенный сценарий, в котором может потребоваться задать значение rebaseClientPath false , заключается в том, когда необходимо переписать URL-адрес, и вы используете темы и перенаправляете URL-адрес в ресурс, расположенный в папке, отличной от запрошенного ресурса.

См. также раздел

Применяется к

RewritePath(String)

Перезаписывает URL-адрес, используя заданный путь.

public:
 void RewritePath(System::String ^ path);

public void RewritePath (string path);

member this.RewritePath : string -> unit

Public Sub RewritePath (path As String)

Параметры

path: String

Внутренний путь перезаписи.

Исключения

ArgumentNullException

Параметр path имеет значение null.

HttpException

Параметр path отсутствует в корневом каталоге текущего приложения.

Примеры

В следующем примере показано, как использовать RewritePath метод, чтобы веб-сайт мог реагировать на URL-адреса, которые не отражают структуру файлов на веб-сайте. Первый блок кода — это веб-страница ASP.NET с именем RewritePath.aspx. Для этого требуется строка запроса. Если имя сайта — WebSite1, в браузере отображается URL-адрес http://localhost/WebSite1/RewritePath.aspx?page=1 "Страница 1". Блок кода, следующий за веб-страницей, является обработчиком Application_BeginRequest событий в файле Global.asax. Этот код перехватывает запросы для URL-адресов, таких как http://localhost/WebSite1/page1 и преобразует их в форму, необходимую для RewritePath.aspx перед их обработкой. Таким образом, URL-адрес http://localhost/WebSite1/page1 вызывает RewritePath.aspx с параметром строки запроса, который отображает page 1 в браузере. При получении URL-адреса http://localhost/WebSite1/page1 вызывается перегрузка RewritePath , которая позволяет указать значение свойства PathInfo , а также параметр строки запроса.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    protected void Page_Load(object sender, EventArgs e)
    {
        Label1.Text = "Page=" + Request.QueryString["page"] + " PathInfo=" + Request.PathInfo;
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Protected Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        Label1.Text = "Page=" & Request.QueryString("page") & " PathInfo=" & Request.PathInfo
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title></title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:Label ID="Label1" runat="server" Text="Label"></asp:Label>
    </div>
    </form>
</body>
</html>

void Application_BeginRequest(Object sender, EventArgs e)
{
    string originalPath = HttpContext.Current.Request.Path.ToLower();
    if (originalPath.Contains("/page1"))
    {
        Context.RewritePath(originalPath.Replace("/page1", "/RewritePath.aspx?page=page1"));
    }
    if (originalPath.Contains("/page2"))
    {
        Context.RewritePath(originalPath.Replace("/page2", "/RewritePath.aspx"), "pathinfo", "page=page2");
    }
}

Sub Application_BeginRequest(ByVal sender As Object, ByVal e As EventArgs)
    Dim originalPath As String = HttpContext.Current.Request.Path.ToLower()
    If originalPath.Contains("/page1") Then
        Context.RewritePath(originalPath.Replace("/page1", "/RewritePath.aspx?page=page1"))
    End If
    If originalPath.Contains("/page2") Then
        Context.RewritePath(originalPath.Replace("/page2", "/RewritePath.aspx"), "pathinfo", "page=page2")
    End If
End Sub

Метод RewritePath(String) перенаправляет запрос ресурса на другой путь, отличный от пути, указанного запрошенным URL-адресом. Если необходимо сбросить виртуальный путь, чтобы запросы от клиента для серверных ресурсов разрешались правильно, используйте перегрузку этого метода, который принимает rebaseClientPath параметр, и задайте для параметра значение false.

См. также раздел

Применяется к

HttpContext.RewritePath Метод

Определение

Перегрузки

RewritePath(String, String, String, Boolean)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

RewritePath(String, String, String)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

RewritePath(String, Boolean)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

RewritePath(String)

Параметры

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Дополнительные ресурсы