HttpContext.RewritePath Method (String, String, String)
Rewrites the URL by using the given path, path information, and query string information.
Assembly: System.Web (in System.Web.dll)
Parameters
- filePath
-
Type:
System.String
The internal rewrite path.
- pathInfo
-
Type:
System.String
Additional path information for a resource. For more information, see PathInfo.
- queryString
-
Type:
System.String
The request query string.
| Exception | Condition |
|---|---|
| ArgumentNullException | The path parameter is not in the current application's root directory. |
| HttpException | The filePath parameter is not in the current application's root directory. |
The RewritePath method redirects a request for a resource to another resource without changing the URL.
The filePath parameter does not include the pathInfo parameter content. For the URL http://www.microsoft.com/virdir/page.html/tail, the filePath parameter is http://www.microsoft.com/virdir/page.html, and the pathInfo parameter is tail.
URL rewriting is useful when you want to restructure the pages in your Web application, and you want to make sure that people who have bookmarked old URLs can still use them after you have moved pages. URL rewriting enables you to transparently forward requests to the new page location.
If you want to enable a site to use URLs that are more user-friendly and are optimized for search engines, a more robust alternative is to use ASP.NET routing. For more information, see ASP.NET Routing.
For a code example, including an example of this method overload, see the RewritePath(String) method overload.
Available since 1.1