HttpContext.RewritePath Метод

Определение

Перенаправляет запрос ресурса по пути, отличному от указанного в запрошенном 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.

Исключения

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

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

Примеры

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

Комментарии

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

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

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

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

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

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

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

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

Исключения

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

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

Примеры

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

Комментарии

RewritePathМетод перенаправляет запрос ресурса на другой ресурс, не изменяя URL-адрес.

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

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

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

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

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

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 для сохранения виртуального пути без изменений.

Исключения

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

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

Примеры

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

Комментарии

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

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

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

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

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

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

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

Исключения

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

Параметр 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 с параметром строки запроса, который отображает «стр. 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 .

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

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

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

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