HttpServerUtility HttpServerUtility HttpServerUtility HttpServerUtility Class

定義

提供 Helper 方法以處理 Web 要求。Provides helper methods for processing Web requests.

public ref class HttpServerUtility sealed
public sealed class HttpServerUtility
type HttpServerUtility = class
Public NotInheritable Class HttpServerUtility
繼承
HttpServerUtilityHttpServerUtilityHttpServerUtilityHttpServerUtility

範例

含有原始程式碼的 Visual Studio Web site 專案位於本主題隨附了:下載A Visual Studio Web site project with source code is available to accompany this topic: Download.

下列範例示範如何使用HtmlEncode方法和UrlEncode方法HttpServerUtility類別。The following example demonstrates how to use the HtmlEncode method and the UrlEncode method of the HttpServerUtility class. HtmlEncode方法可協助確保使用者提供的任何字串輸入會轉譯為靜態文字,而不是可執行的指令碼或 HTML 元素的瀏覽器中。The HtmlEncode method helps ensure that any user-supplied string input will be rendered as static text in browsers instead of executable script or HTML elements. UrlEncode方法編碼 Url,以便正確地傳送 HTTP 資料流中。The UrlEncode method encodes URLs so that they are correctly transmitted in the HTTP stream.

<%@ 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類別會公開透過內建ServerASP.NET 所提供的物件。The methods and properties of the HttpServerUtility class are exposed through the intrinsic Server object provided by ASP.NET.

屬性

MachineName MachineName MachineName MachineName

取得伺服器的電腦名稱。Gets the server's computer name.

ScriptTimeout ScriptTimeout ScriptTimeout ScriptTimeout

取得或設定要求的逾時值 (以秒為單位)。Gets or sets the request time-out value in seconds.

方法

ClearError() ClearError() ClearError() ClearError()

清除先前的例外狀況。Clears the previous exception.

CreateObject(String) CreateObject(String) CreateObject(String) CreateObject(String)

建立物件程式設計識別項 (ProgID) 所識別之 COM 物件的伺服器執行個體。Creates a server instance of a COM object identified by the object's programmatic identifier (ProgID).

CreateObject(Type) CreateObject(Type) CreateObject(Type) CreateObject(Type)

建立以物件類型識別的 COM 物件的伺服器執行個體。Creates a server instance of a COM object identified by the object's type.

CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String) CreateObjectFromClsid(String)

建立以物件的類別識別項 (CLSID) 識別的 COM 物件的伺服器執行個體。Creates a server instance of a COM object identified by the object's class identifier (CLSID).

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean) Execute(IHttpHandler, TextWriter, Boolean)

在目前要求的內容中,執行指定虛擬路徑的處理常式。Executes the handler for the specified virtual path in the context of the current request. TextWriter 會擷取已執行處理常式的輸出,並且布林參數會指定是否要清除 QueryStringForm 集合。A TextWriter captures output from the executed handler and a Boolean parameter specifies whether to clear the QueryString and Form collections.

Execute(String) Execute(String) Execute(String) Execute(String)

在目前要求的內容中,執行指定虛擬路徑的處理常式。Executes the handler for the specified virtual path in the context of the current request.

Execute(String, Boolean) Execute(String, Boolean) Execute(String, Boolean) Execute(String, Boolean)

在目前要求的內容中,執行指定虛擬路徑的處理常式,並指定是否清除 QueryStringForm 集合。Executes the handler for the specified virtual path in the context of the current request and specifies whether to clear the QueryString and Form collections.

Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter) Execute(String, TextWriter)

在目前要求的內容中,執行指定虛擬路徑的處理常式。Executes the handler for the specified virtual path in the context of the current request. TextWriter 會擷取已執行處理常式的輸出。A TextWriter captures output from the executed handler.

Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean) Execute(String, TextWriter, Boolean)

在目前要求的內容中,執行指定虛擬路徑的處理常式。Executes the handler for the specified virtual path in the context of the current request. TextWriter 會擷取網頁的輸出,並且布林參數會指定是否要清除 QueryStringForm 集合。A TextWriter captures output from the page and a Boolean parameter specifies whether to clear the QueryString and Form collections.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetLastError() GetLastError() GetLastError() GetLastError()

傳回先前的例外狀況。Returns the previous exception.

GetType() GetType() GetType() GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
HtmlDecode(String) HtmlDecode(String) HtmlDecode(String) HtmlDecode(String)

將 HTML 編碼字串解碼,並傳回解碼的字串。Decodes an HTML-encoded string and returns the decoded string.

HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter) HtmlDecode(String, TextWriter)

將 HTML 編碼字串解碼,並送出結果輸出至 TextWriter 輸出資料流。Decodes an HTML-encoded string and sends the resulting output to a TextWriter output stream.

HtmlEncode(String) HtmlEncode(String) HtmlEncode(String) HtmlEncode(String)

將字串作 HTML 編碼,並傳回編碼的字串。HTML-encodes a string and returns the encoded string.

HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter) HtmlEncode(String, TextWriter)

將字串作 HTML 編碼,並送出結果輸出至 TextWriter 輸出資料流。HTML-encodes a string and sends the resulting output to a TextWriter output stream.

MapPath(String) MapPath(String) MapPath(String) MapPath(String)

傳回對應至指定虛擬路徑的實體檔案路徑。Returns the physical file path that corresponds to the specified virtual path.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(Inherited from Object)
Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean) Transfer(IHttpHandler, Boolean)

結束目前網頁的執行,並使用實作 IHttpHandler 介面的自訂 HTTP 處理常式開始執行新要求,以及指定是否要清除 QueryStringForm 集合。Terminates execution of the current page and starts execution of a new request by using a custom HTTP handler that implements the IHttpHandler interface and specifies whether to clear the QueryString and Form collections.

Transfer(String) Transfer(String) Transfer(String) Transfer(String)

針對目前的要求結束目前網頁的執行,並使用指定的網頁 URL 路徑開始執行新網頁。For the current request, terminates execution of the current page and starts execution of a new page by using the specified URL path of the page.

Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean) Transfer(String, Boolean)

結束目前網頁的執行,並使用指定的網頁 URL 路徑開始執行新網頁。Terminates execution of the current page and starts execution of a new page by using the specified URL path of the page. 指定是否要清除 QueryStringForm 集合。Specifies whether to clear the QueryString and Form collections.

TransferRequest(String) TransferRequest(String) TransferRequest(String) TransferRequest(String)

執行所指定 URL 的非同步執行工作。Performs an asynchronous execution of the specified URL.

TransferRequest(String, Boolean) TransferRequest(String, Boolean) TransferRequest(String, Boolean) TransferRequest(String, Boolean)

執行所指定 URL 的非同步執行工作,並保留查詢字串參數。Performs an asynchronous execution of the specified URL and preserves query string parameters.

TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection) TransferRequest(String, Boolean, String, NameValueCollection)

使用指定的 HTTP 方法與標頭執行所指定 URL 的非同步執行工作。Performs an asynchronous execution of the specified URL using the specified HTTP method and headers.

TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean) TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

使用指定的 HTTP 方法、標頭和路徑,並選擇性地保留表單值和使用者識別,執行所指定 URL 的非同步執行。Performs an asynchronous execution of the specified URL using the specified HTTP method, headers, and path, and optionally preserves form values and the user identity.

UrlDecode(String) UrlDecode(String) UrlDecode(String) UrlDecode(String)

將字串作 URL 解碼,並傳回解碼的字串。URL-decodes a string and returns the decoded string.

UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) UrlDecode(String, TextWriter) UrlDecode(String, TextWriter)

將 URL 中收到的 HTML 字串解碼,並送出結果輸出至 TextWriter 輸出資料流。Decodes an HTML string received in a URL and sends the resulting output to a TextWriter output stream.

UrlEncode(String) UrlEncode(String) UrlEncode(String) UrlEncode(String)

將字串作 URL 編碼,並傳回編碼的字串。URL-encodes a string and returns the encoded string.

UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter) UrlEncode(String, TextWriter)

將字串作 URL 編碼,並送出結果輸出至 TextWriter 輸出資料流。URL-encodes a string and sends the resulting output to a TextWriter output stream.

UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String) UrlPathEncode(String)

請勿使用,只在需要瀏覽器相容性時使用。Do not use; intended only for browser compatibility. 使用 UrlEncode(String)Use UrlEncode(String).

UrlTokenDecode(String) UrlTokenDecode(String) UrlTokenDecode(String) UrlTokenDecode(String)

使用 Base 64 數字,將 URL 字串語彙基元解碼成其對應的位元組陣列。Decodes a URL string token to its equivalent byte array using base 64 digits.

UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[]) UrlTokenEncode(Byte[])

將位元組陣列編碼成其對等的字串表示,該字串使用 Base 64 數字且可在 URL 上傳輸。Encodes a byte array into its equivalent string representation using base 64 digits, which is usable for transmission on the URL.

適用於

另請參閱