ASP.NET页面对象 - Request
获取请求的页的 HttpRequest 对象。
一、
HttpRequest 类
使
ASP.NET 能够读取客户端在
Web 请求期间发送的
HTTP 值。
下面的代码示例使用
StreamWriter 类将若干
HttpRequest 类属性值的值写入文件。对于是字符串类型的属性，属性值被写入文件时将被编码为
HTML。表示集合的属性会被依次通过，而这些属性包含的各个键
/值对都会被写入该文件。
<%@ Page Language="C#" %>
<%@ import Namespace="System.Threading" %>
<%@ import Namespace="System.IO" %>
<script runat="server">
/* NOTE: To use this sample, create a c:/temp/CS folder,
* add the ASP.NET account (in IIS 5.x <machinename>/ASPNET,
* in IIS 6.x NETWORK SERVICE), and give it write permissions
* to the folder.*/
private const string INFO_DIR = @"c:/temp/CS/RequestDetails";
public static int requestCount;
private void Page_Load(object sender, System.EventArgs e)
{
// Create a variable to use when iterating
// through the UserLanguages property.
int langCount;
int requestNumber = Interlocked.Increment(ref requestCount);
// Create the file to contain information about the request.
string strFilePath = INFO_DIR + requestNumber.ToString() + @".txt";
StreamWriter sw = File.CreateText(strFilePath);
try
{
// Write request information to the file with HTML encoding.
sw.WriteLine(Server.HtmlEncode(DateTime.Now.ToString()));
sw.WriteLine(Server.HtmlEncode(Request.CurrentExecutionFilePath));
sw.WriteLine(Server.HtmlEncode(Request.ApplicationPath));
sw.WriteLine(Server.HtmlEncode(Request.FilePath));
sw.WriteLine(Server.HtmlEncode(Request.Path));
// Iterate through the Form collection and write
// the values to the file with HTML encoding.
// String[] formArray = Request.Form.AllKeys;
foreach (string s in Request.Form)
{
sw.WriteLine("Form: " + Server.HtmlEncode(s));
}
// Write the PathInfo property value
// or a string if it is empty.
if (Request.PathInfo == String.Empty)
{
sw.WriteLine("The PathInfo property contains no information.");
}
else
{
sw.WriteLine(Server.HtmlEncode(Request.PathInfo));
}
// Write request information to the file with HTML encoding.
sw.WriteLine(Server.HtmlEncode(Request.PhysicalApplicationPath));
sw.WriteLine(Server.HtmlEncode(Request.PhysicalPath));
sw.WriteLine(Server.HtmlEncode(Request.RawUrl));
// Write a message to the file dependent upon
// the value of the TotalBytes property.
if (Request.TotalBytes > 1000)
{
sw.WriteLine("The request is 1KB or greater");
}
else
{
sw.WriteLine("The request is less than 1KB");
}
// Write request information to the file with HTML encoding.
sw.WriteLine(Server.HtmlEncode(Request.RequestType));
sw.WriteLine(Server.HtmlEncode(Request.UserHostAddress));
sw.WriteLine(Server.HtmlEncode(Request.UserHostName));
sw.WriteLine(Server.HtmlEncode(Request.HttpMethod));
// Iterate through the UserLanguages collection and
// write its HTML encoded values to the file.
for (langCount=0; langCount < Request.UserLanguages.Length; langCount++)
{
sw.WriteLine(@"User Language " + langCount +": " + Server.HtmlEncode(Request.UserLanguages[langCount]));
}
}
finally
{
// Close the stream to the file.
sw.Close();
}
lblInfoSent.Text = "Information about this request has been sent to a file.";
}
private void btnSendInfo_Click(object sender, System.EventArgs e)
{
lblInfoSent.Text = "Hello, " + Server.HtmlEncode(txtBoxName.Text) +
". You have created a new request info file.";
}
</script>
<html>
<head>
</head>
<body>
<form runat="server">
<p>
</p>
<p>
Enter your hame here:
<asp:TextBox id="txtBoxName" runat="server"></asp:TextBox>
</p>
<p>
<asp:Button id="btnSendInfo" runat="server" Text="Click Here"></asp:Button>
</p>
<p>
<asp:Label id="lblInfoSent" runat="server"></asp:Label>
</p>
</form>
</body>
</html>
二、
HttpRequest 成员
公共构造函数
|
名称
|
说明
|
|
HttpRequest
|
初始化
HttpRequest 对象。
|
公共属性
|
名称
|
说明
|
|
AcceptTypes
|
获取客户端支持的 MIME 接受类型的字符串数组。
|
|
AnonymousID
|
获取该用户的匿名标识符（如果存在）。
|
|
ApplicationPath
|
获取服务器上 ASP.NET 应用程序的虚拟应用程序根路径。
|
|
AppRelativeCurrentExecutionFilePath
|
获取应用程序根的虚拟路径，并通过对应用程序根使用波形符 (~) 表示法（例如，以“~/page.aspx”的形式）使该路径成为相对路径。
|
|
Browser
|
获取或设置有关正在请求的客户端的浏览器功能的信息。
|
|
ClientCertificate
|
获取当前请求的客户端安全证书。
|
|
ContentEncoding
|
获取或设置实体主体的字符集。
|
|
ContentLength
|
指定客户端发送的内容长度（以字节计）。
|
|
ContentType
|
获取或设置传入请求的 MIME 内容类型。
|
|
Cookies
|
获取客户端发送的 cookie 的集合。
|
|
CurrentExecutionFilePath
|
获取当前请求的虚拟路径。
|
|
FilePath
|
获取当前请求的虚拟路径。
|
|
Files
|
获取采用多部分 MIME 格式的由客户端上载的文件的集合。
|
|
Filter
|
获取或设置在读取当前输入流时要使用的筛选器。
|
|
Form
|
获取窗体变量集合。
|
|
Headers
|
获取 HTTP 头集合。
|
|
HttpMethod
|
获取客户端使用的 HTTP 数据传输方法（如
GET、POST 或 HEAD）。
|
|
InputStream
|
获取传入的 HTTP 实体主体的内容。
|
|
IsAuthenticated
|
获取一个值，该值指示是否验证了请求。
|
|
IsLocal
|
获取一个值，该值指示该请求是否来自本地计算机。
|
|
IsSecureConnection
|
获取一个值，该值指示 HTTP 连接是否使用安全套接字（即 HTTPS）。
|
|
Item
|
从
Cookies、Form、QueryString 或 ServerVariables 集合中获取指定的对象。
|
|
LogonUserIdentity
|
获取当前用户的
WindowsIdentity 类型。
|
|
Params
|
获取
QueryString、Form、ServerVariables 和 Cookies项的组合集合。
|
|
Path
|
获取当前请求的虚拟路径。
|
|
PathInfo
|
获取具有 URL 扩展名的资源的附加路径信息。
|
|
PhysicalApplicationPath
|
获取当前正在执行的服务器应用程序的根目录的物理文件系统路径。
|
|
PhysicalPath
|
获取与请求的 URL 相对应的物理文件系统路径。
|
|
QueryString
|
获取 HTTP 查询字符串变量集合。
|
|
RawUrl
|
获取当前请求的原始 URL。
|
|
RequestType
|
获取或设置客户端使用的 HTTP 数据传输方法（
GET 或
POST）。
|
|
ServerVariables
|
获取 Web 服务器变量的集合。
|
|
TotalBytes
|
获取当前输入流中的字节数。
|
|
Url
|
获取有关当前请求的 URL 的信息。
|
|
UrlReferrer
|
获取有关客户端上次请求的 URL 的信息，该请求链接到当前的 URL。
|
|
UserAgent
|
获取客户端浏览器的原始用户代理信息。
|
|
UserHostAddress
|
获取远程客户端的 IP 主机地址。
|
|
UserHostName
|
获取远程客户端的 DNS 名称。
|
|
UserLanguages
|
获取客户端语言首选项的排序字符串数组。
|
公共方法
|
名称
|
说明
|
|
BinaryRead
|
执行对当前输入流进行指定字节数的二进制读取。
|
|
Equals
|
已重载。 确定两个
Object 实例是否相等。 （从
Object 继承。）
|
|
GetHashCode
|
用作特定类型的哈希函数。
GetHashCode适合在哈希算法和数据结构（如哈希表）中使用。 （从
Object 继承。）
|
|
GetType
|
获取当前实例的
Type。 （从
Object 继承。）
|
|
MapImageCoordinates
|
将传入图像字段窗体参数映射为适当的 x 坐标值和 y 坐标值。
|
|
MapPath
|
已重载。 为当前请求将请求的 URL 中的虚拟路径映射到服务器上的物理路径。
|
|
ReferenceEquals
|
确定指定的
Object实例是否是相同的实例。 （从 Object 继承。）
|
|
SaveAs
|
将 HTTP 请求保存到磁盘。
|
|
ToString
|
返回表示当前
Object的 String。 （从 Object 继承。）
|
|
ValidateInput
|
对通过
Cookies 、
Form和
QueryString 属性访问的集合进行验证。
|
受保护的方法
|
名称
|
说明
|
|
Finalize
|
允许
Object在“垃圾回收”回收 Object之前尝试释放资源并执行其他清理操作。 （从 Object 继承。）
|
|
MemberwiseClone
|
创建当前
Object的浅表副本。 （从 Object 继承。）
|
三、
Request对象三种取得数据的方法
Request对象功能是从客户端得到数据，常用的三种取得数据的方法是：
Request.Form、
Request.QueryString，
Request。其第三种是前两种的一个缩写，可以取代前两种情况。而前两种主要对应的
Form提交时的两种不同的提交方法：分别是
Post方法和
Get方法。
Request 对象的属性和方法比较多，常用的几个为：
UserAgent 传回客户端浏览器的版本信息，
UserHostAddress 传回远方客户端机器的主机
IP 地址，
UserHostName 传回远方客户端机器的
DNS 名称，
PhysicalApplicationPath 传回目前请求网页在
Server 端的真实路径。
1、从浏览器获取数据
利用
Request方法，可以读取其他页面提交过来的数据。提交的数据有两种形式：一种是通过
Form表单提交过来，另一种是通过超级链接后面的参数提交过来，两种方式都可以利用
Request对象读取。
<%@ Page Language="C#"%>
<%
string strUserName = Request["Name"];
string strUserLove = Request["Love"];
%>
姓名：<%=strUserName%>
爱好：<%=strUserLove%>
<form action="" method="post">
<P>姓名：<input type="TEXT" size="20" name="Name"></P>
<P>兴趣：<input type="TEXT" size="20" name="Love"></P>
<P><input type="submit" value="提交"></P>
</form>
2、得到客户端的信息
利用
Request对象内置的属性，可以得到一些客户端的信息，比如客户端浏览器版本和客户端地址等等
<%@ Page Language="C#"%>
客户端浏览器：<%=Request.UserAgent %>
客户端IP地址：<%=Request.UserHostAddress %>
当前文件服务端物理路径：<%=Request.PhysicalApplicationPath %>
四、
Request对象包括：
报头
客户端的基本信息（如浏览器类型、版本号、用户所用的语言及编码方式等）
请求方法（
Post或
Get）
参数名
参数值
Request对象的调用方法：
Request.Collection["Variable"]
其中，
Collection有
QueryString、
Form、
Cookies、
ServerVariables四种集合。
Collection可以省略，如用
Request["Variable"]调用，但这样会降低效率。
以下是这四种集合：
1、
QueryString集合
QueryString集合收集的信息来自于请求
Url中“？”号后面的数据，这些数据通常称为“
Url附加信息”：
http://www.aspcn.com/show.asp?id=111
在此
Url中，
QueryString收集到的信息是“
Show.asp?”后的附加数据“
id=111”。
此时，取得参数
id的参数值的语句是：
Request.QueryString["id"]
QueryString集合主要用于收集
Http协议中的
Get请求发送的数据，如果一个请求事件中被请求的程序
Url中出现“？”号后的数据，则表示此次请求方式为
Get。最常用的超链接，就是通过
Get发送请求。也可以通过
Form发送
Get请求。
那么，在
show.asp页面中，就可以用
Request.QueryString["id"]获得
id的参数值。
2、
Form集合
Form集合与
QueryString类似，但它用于收集
Post方法发送的请求数据（
Get方法一般只能传递
256字节的数据，而
Post可以达到
2M）。
Post请求必须由
Form来发送。那么，在
show.asp页面中，就可以用
Request.Form["id"]获得
id的参数值。
3、
Cookies集合
4、
ServerVariable集合
ServerVariable（环境变量）集合中包含了服务器和客户端的系统信息。
---客户端：
(1)获取客户端浏览器版本号： Request.ServerVariable["HTTP_USER_AGENT"]
(2)获取客户端IP地址： Request.ServerVariable["REMOTE_ADDR"]
(3)获取客户端所使用的语言： HTTP_ACCEPT_LANGUAGE
(4)获取请求的方法： REQUEST_METHOD
(5)获取请求信息的内容的总符数： CONTENT_LENGTH
(6)获取请求信息的类型 CONTENT_TYPE
(7)获取URL的附加信息： QUERY_STRING
(8)获取网关接口： GATEWAY_INTERFACE
---服务器：
(1)获取服务器的IP地址： Request.ServerVariable["LOCAL_ADDR"]
(2)获取服务器的主机名： Request.ServerVariable["SERVER_NAME"]
(3)获取当前执行程序的虚拟目录： PATH_INFO
(4)获取当前执行程序的绝对路径： PATH_TRANSLATED
(5)获取当前程序的文件名（包含虚拟路径）： SCRIPT_NAME
(6)获取服务器接受请求的端口： SERVER_PORT
(7)获取服务器遵从的协议及版本号： SERVER_PROTOCAL
Browser对象
ASP.net的Browser对象是通过调用Request的Browser属性直接获得的，它可以获得浏览器的更深入的信息
检测浏览器的类型： Request.Brower.Brower 显示结果，例如 IE
检测浏览器的版本： Requet.Brower.Version 显示结果，例如 6.0b
检测浏览器是否支持ActiveX控件： ActiveXControls
检测浏览器是否支持Cookies： Cookies
检测浏览器是否支持VBScript： VBSCript
其它
Request属性、方法：
* FilePath 取得当前请求的文件路径，例： String filePath = Request.FilePath;
* HttpMethod 取得当前请求的方法
* Files
* Params 获得 QueryString + Form + ServerVariable + Cookies 的集合。
* TotalBytes 请求内容的大小
* Url 获得Url信息，例：
HttpUrl objUrl = Request.URL;
string sPort = objUrl.Port;
string sProtocol = objUrl.Protocol;
* UserHostAddress（用户IP）、UserHostName、UserLanguages
五、
Request获取
url信息的各种方法比较
在
ASP.NET编程中经常需要用
Request获取
url的有关信息，
Request中有多种方法获取
url信息，但我经常忘了各种方法的具体作用，今天我就写了个测试程序，将各种方法得到的结果列出来，以后用时直接参考一下就行了。
测试的
url地址是
[url]http://www.test.com/testweb/default.aspx[/url], 结果如下：
Request.ApplicationPath: /testweb
Request.CurrentExecutionFilePath: /testweb/default.aspx
Request.FilePath: /testweb/default.aspx
Request.Path: /testweb/default.aspx
Request.PathInfo:
Request.PhysicalApplicationPath: E:/WWW/testweb/获取当前正在执行的服务器应用程序的根目录的物理文件系统路径。
Request.PhysicalPath: E:/WWW/testweb/default.aspx
Request.RawUrl: /testweb/default.aspx
Request.Url.AbsolutePath: /testweb/default.aspx
Request.Url.AbsoluteUri: [url]http://www.test.com/testweb/default.aspx[/url]
Request.Url.Host: [url]www.test.com[/url]
Request.Url.LocalPath: /testweb/default.aspx
六、获取客户端信息
Response.Write("客户端计算机名：" + Request.UserHostName + "<BR />");
Response.Write("客户端IP：" + Request.UserHostAddress + "<BR />");
Response.Write("浏览器：" + Request.Browser.Browser + "<BR />");
Response.Write("浏览器版本：" + Request.Browser.Version + "<BR />");
Response.Write("浏览器类型：" + Request.Browser.Type + "<BR />");
Response.Write("客户端操作系统：" + Request.Browser.Platform + "<BR />");
Response.Write("是否支持Java：" + Request.Browser.JavaApplets + "<BR />");
Response.Write("是否支持框架网页：" + Request.Browser.Frames + "<BR />");
Response.Write("是否支持Cookie：" + Request.Browser.Cookies + "<BR />");
Response.Write("客户端.NET Framework版本：" + Request.Browser.ClrVersion + "<BR />");
Response.Write("JScript版本：" + Request.Browser.JScriptVersion + "<BR />");
Response.Write("请求的虚拟路径：" + Request.Path + "<BR />");
//Response.Write("title：" + Request.He + "<BR />");
for(int i=0;i<Request.Headers.Count;i++){
Response.Write(Request.Headers.Keys[i]+":" + Request.Headers[Request.Headers.Keys[i]]+ "<BR />");
}
Response.Write("请求的物理路径：" + Request.PhysicalPath + "<BR />");
Response.Write("浏览器类型和版本：" + Request.ServerVariables["HTTP_USER_AGENT"] + "<BR />");
Response.Write("用户的IP地址：" + Request.ServerVariables["REMOTE_ADDR"] + "<BR />");
Response.Write("请求的方法：" + Request.ServerVariables["REQUEST_METHOD"] + "<BR />");
Response.Write("服务器的IP地址：" + Request.ServerVariables["LOCAL_ADDR"] + "<BR />");
http://blog.csdn.net/dodream/article/details/4798820