HttpServerUtility 类

定义

提供用于处理 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 捕获执行的处理程序的输出,布尔参数则指定是否清除 QueryStringForm 集合。

Execute(String)

在当前请求的上下文中执行指定虚拟路径的处理程序。

Execute(String, Boolean)

在当前请求的上下文中执行指定虚拟路径的处理器,并指定是否清除 QueryStringForm 集合。

Execute(String, TextWriter)

在当前请求的上下文中执行指定虚拟路径的处理程序。 TextWriter 捕获执行的处理程序的输出。

Execute(String, TextWriter, Boolean)

在当前请求的上下文中执行指定虚拟路径的处理程序。 TextWriter 捕获页面输出,布尔参数则指定是否清除 QueryStringForm 集合。

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 处理程序开始新请求的执行,并指定是否清除 QueryStringForm 集合。

Transfer(String)

对于当前请求,终止当前页的执行,并使用指定的页 URL 路径来开始执行一个新页。

Transfer(String, Boolean)

终止当前页的执行,并使用指定的页 URL 路径来开始执行一个新页。 指定是否清除 QueryStringForm 集合。

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 传输数据的编码方案。

适用于

另请参阅