HttpServerUtility 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供用于处理 Web 请求的帮助程序方法。
public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
- 继承
-
HttpServerUtility
示例
下面的示例演示如何使用 HtmlEncode 该方法和 UrlEncode 类的方法 HttpServerUtility 。 该方法 HtmlEncode 有助于确保在浏览器中将任何用户提供的字符串输入呈现为静态文本,而不是可执行脚本或 HTML 元素。 该方法 UrlEncode 对 URL 进行编码,以便在 HTTP 流中正确传输这些 URL。
<%@ 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) |
创建由对象的编程标识符(ProgID)标识的 COM 对象的服务器实例。 |
| CreateObject(Type) |
创建由对象类型标识的 COM 对象的服务器实例。 |
| CreateObjectFromClsid(String) |
创建由对象的类标识符(CLSID)标识的 COM 对象的服务器实例。 |
| Equals(Object) |
确定指定的对象是否等于当前对象。 (继承自 Object) |
| Execute(IHttpHandler, TextWriter, Boolean) |
在当前请求的上下文中为指定的虚拟路径执行处理程序。 捕获 TextWriter 执行处理程序的输出,布尔参数指定是否清除 QueryString 和 Form 集合。 |
| Execute(String, Boolean) |
在当前请求的上下文中为指定的虚拟路径执行处理程序,并指定是否清除 QueryString 和 Form 集合。 |
| Execute(String, TextWriter, Boolean) |
在当前请求的上下文中为指定的虚拟路径执行处理程序。 捕获 TextWriter 页面的输出,布尔参数指定是否清除 QueryString 和 Form 集合。 |
| Execute(String, TextWriter) |
在当前请求的上下文中为指定的虚拟路径执行处理程序。 捕获 TextWriter 已执行的处理程序的输出。 |
| Execute(String) |
在当前请求的上下文中为指定的虚拟路径执行处理程序。 |
| GetHashCode() |
用作默认哈希函数。 (继承自 Object) |
| GetLastError() |
返回上一个异常。 |
| GetType() |
获取当前实例的 Type。 (继承自 Object) |
| HtmlDecode(String, TextWriter) |
解码 HTML 编码的字符串,并将生成的输出发送到 TextWriter 输出流。 |
| HtmlDecode(String) |
解码 HTML 编码的字符串并返回解码的字符串。 |
| HtmlEncode(String, TextWriter) |
HTML 对字符串进行编码,并将生成的输出发送到 TextWriter 输出流。 |
| HtmlEncode(String) |
HTML 对字符串进行编码并返回编码的字符串。 |
| MapPath(String) |
返回对应于指定虚拟路径的物理文件路径。 |
| MemberwiseClone() |
创建当前 Object的浅表副本。 (继承自 Object) |
| ToString() |
返回一个表示当前对象的字符串。 (继承自 Object) |
| Transfer(IHttpHandler, Boolean) |
终止当前页的执行,并使用实现 IHttpHandler 接口的自定义 HTTP 处理程序开始执行新请求,并指定是否清除 QueryString 和 Form 集合。 |
| Transfer(String, Boolean) |
终止当前页的执行,并使用页面的指定 URL 路径开始执行新页面。 指定是否清除 QueryString 和 Form 集合。 |
| Transfer(String) |
对于当前请求,终止当前页的执行,并使用页面的指定 URL 路径开始执行新页面。 |
| TransferRequest(String, Boolean, String, NameValueCollection, Boolean) |
使用指定的 HTTP 方法、标头和路径执行指定 URL 的异步执行,并选择性地保留表单值和用户标识。 |
| TransferRequest(String, Boolean, String, NameValueCollection) |
使用指定的 HTTP 方法和标头执行指定的 URL 的异步执行。 |
| TransferRequest(String, Boolean) |
执行指定 URL 的异步执行并保留查询字符串参数。 |
| TransferRequest(String) |
执行指定 URL 的异步执行。 |
| UrlDecode(String, TextWriter) |
解码 URL 中收到的 HTML 字符串,并将生成的输出发送到 TextWriter 输出流。 |
| UrlDecode(String) |
URL 解码字符串并返回解码的字符串。 |
| UrlEncode(String, TextWriter) |
URL 对字符串进行编码,并将生成的输出发送到 TextWriter 输出流。 |
| UrlEncode(String) |
URL 对字符串进行编码并返回编码的字符串。 |
| UrlPathEncode(String) |
请勿使用;仅用于浏览器兼容性。 使用 UrlEncode(String)。 |
| UrlTokenDecode(String) |
使用 base 64 数字将 URL 字符串令牌解码为其等效的字节数组。 |
| UrlTokenEncode(Byte[]) |
使用 base 64 数字将字节数组编码为其等效的字符串表示形式,该数字可用于在 URL 上传输。 |