HttpServerUtility 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供用于处理 Web 请求的 Helper 方法。
public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
- 继承
-
HttpServerUtility
示例
Visual Studio包含源代码的网站项目可随本主题一起提供:下载。
下面的示例演示如何使用 HtmlEncode 该类的方法和 UrlEncode 方法 HttpServerUtility 。 此方法 HtmlEncode 有助于确保任何用户提供的字符串输入在浏览器中呈现为静态文本,而不是可执行脚本或 HTML 元素。 该方法 UrlEncode 对 URL 进行编码,使其在 HTTP 流中正确传输。
<%@ 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 Button1_Click(object sender, EventArgs e)
{
if (!String.IsNullOrEmpty(TextBox1.Text))
{
// Access the HttpServerUtility methods through
// the intrinsic Server object.
Label1.Text = "Welcome, " +
Server.HtmlEncode(TextBox1.Text) +
".<br/> The url is " +
Server.UrlEncode(Request.Url.ToString());
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>HttpServerUtility Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
Enter your name:<br />
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
<br />
<asp:Label ID="Label1" runat="server"/>
</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 Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
If (Not String.IsNullOrEmpty(TextBox1.Text)) Then
' Access the HttpServerUtility methods through
' the intrinsic Server object.
Label1.Text = "Welcome, " & _
Server.HtmlEncode(TextBox1.Text) & _
".<br/> The url is " & _
Server.UrlEncode(Request.Url.ToString())
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head id="Head1" runat="server">
<title>HttpServerUtility Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
Enter your name:<br />
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox>
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="Submit" />
<br />
<asp:Label ID="Label1" runat="server"/>
</div>
</form>
</body>
</html>
注解
类的方法和属性HttpServerUtility通过 ASP.NET 提供的内部Server对象公开。
属性
MachineName |
获取服务器的计算机名称。 |
ScriptTimeout |
获取或设置请求超时值(以秒为单位)。 |
方法
ClearError() |
清除前一个异常。 |
CreateObject(String) |
创建 COM 对象的服务器实例,该 COM 对象由对象的程序标识符 (ProgID) 标识。 |
CreateObject(Type) |
创建由对象类型标识的 COM 对象的一个服务器实例。 |
CreateObjectFromClsid(String) |
创建 COM 对象的服务器实例,该对象由对象的类标识符 (CLSID) 标识。 |
Equals(Object) |
确定指定对象是否等于当前对象。 (继承自 Object) |
Execute(IHttpHandler, TextWriter, Boolean) |
在当前请求的上下文中执行指定虚拟路径的处理程序。 TextWriter 捕获执行的处理程序的输出,布尔参数则指定是否清除 QueryString 和 Form 集合。 |
Execute(String) |
在当前请求的上下文中执行指定虚拟路径的处理程序。 |
Execute(String, Boolean) |
在当前请求的上下文中执行指定虚拟路径的处理器,并指定是否清除 QueryString 和 Form 集合。 |
Execute(String, TextWriter) |
在当前请求的上下文中执行指定虚拟路径的处理程序。 TextWriter 捕获执行的处理程序的输出。 |
Execute(String, TextWriter, Boolean) |
在当前请求的上下文中执行指定虚拟路径的处理程序。 TextWriter 捕获页面输出,布尔参数则指定是否清除 QueryString 和 Form 集合。 |
GetHashCode() |
作为默认哈希函数。 (继承自 Object) |
GetLastError() |
返回前一个异常。 |
GetType() |
获取当前实例的 Type。 (继承自 Object) |
HtmlDecode(String) |
对 HTML 编码的字符串进行解码,并返回已解码的字符串。 |
HtmlDecode(String, TextWriter) |
对 HTML 编码的字符串进行解码,并将结果输出发送到 TextWriter 输出流。 |
HtmlEncode(String) |
对字符串进行 HTML 编码并返回已编码的字符串。 |
HtmlEncode(String, TextWriter) |
对字符串进行 HTML 解码,并将结果输出发送到 TextWriter 输出流。 |
MapPath(String) |
返回与指定虚拟路径相对应的物理文件路径。 |
MemberwiseClone() |
创建当前 Object 的浅表副本。 (继承自 Object) |
ToString() |
返回表示当前对象的字符串。 (继承自 Object) |
Transfer(IHttpHandler, Boolean) |
终止当前页的执行,然后使用实现 IHttpHandler 接口的自定义 HTTP 处理程序开始新请求的执行,并指定是否清除 QueryString 和 Form 集合。 |
Transfer(String) |
对于当前请求,终止当前页的执行,并使用指定的页 URL 路径来开始执行一个新页。 |
Transfer(String, Boolean) |
终止当前页的执行,并使用指定的页 URL 路径来开始执行一个新页。 指定是否清除 QueryString 和 Form 集合。 |
TransferRequest(String) |
异步执行指定的 URL。 |
TransferRequest(String, Boolean) |
异步执行指定的 URL 并保留查询字符串参数。 |
TransferRequest(String, Boolean, String, NameValueCollection) |
使用指定的 HTTP 方法和标头异步执行指定的 URL。 |
TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
用指定的 HTTP 方法、标头和路径,执行指定的 URL 上的异步执行和选择保留格式值和用户标识。 |
UrlDecode(String) |
对字符串进行 URL 解码并返回已解码的字符串。 |
UrlDecode(String, TextWriter) |
对在 URL 中接收的 HTML 字符串进行解码,并将结果输出发送到 TextWriter 输出流。 |
UrlEncode(String) |
对字符串进行 URL 编码,并返回已编码的字符串。 |
UrlEncode(String, TextWriter) |
对字符串进行 URL 编码,并将结果输出发送到 TextWriter 输出流。 |
UrlPathEncode(String) |
请勿使用;仅适用于浏览器兼容性。 请使用 UrlEncode(String)。 |
UrlTokenDecode(String) |
将 URL 字符串标记解码为使用 64 进制数字的等效字节数组。 |
UrlTokenEncode(Byte[]) |
将一个字节数组编码为使用 Base 64 编码方案的等效字符串表示形式,Base 64 是一种适于通过 URL 传输数据的编码方案。 |