HttpServerUtility 類別 (System.Web)

切換檢視:
傳統
輕量型
ScriptFree
.NET Framework 類別庫
HttpServerUtility 類別
本文章是由人工翻譯。 如欲同時瀏覽本網頁和英文原文，請變更您的偏好瀏覽方式為「輕量型」。

提供 Helper 方法以處理 Web 要求。

繼承階層架構
System.Object
  System.Web.HttpServerUtility

命名空間：  System.Web
組件：  System.Web (在 System.Web.dll 中)
語法
Visual Basic
Public NotInheritable Class HttpServerUtility
C#
public sealed class HttpServerUtility
Visual C++
public ref class HttpServerUtility sealed
F#
[<Sealed>]
type HttpServerUtility =  class end

HttpServerUtility 型別會公開下列成員。

屬性
  名稱 說明
公用屬性 MachineName 取得伺服器的電腦名稱。
公用屬性 ScriptTimeout 取得和設定要求的逾時值 (以秒為單位)。
回頁首
方法
  名稱 說明
公用方法 ClearError 清除先前的例外狀況。
公用方法 CreateObject(String) 建立物件程式設計識別項 (ProgID) 所識別之 COM 物件的伺服器執行個體。
公用方法 CreateObject(Type) 建立以物件型別識別的 COM 物件的伺服器執行個體。
公用方法 CreateObjectFromClsid 建立以物件的類別識別項 (CLSID) 識別的 COM 物件的伺服器執行個體。
公用方法 Equals(Object) 判斷指定的 Object 和目前的 Object 是否相等。 (繼承自 Object)。
公用方法 Execute(String) 在目前要求的內容中，執行指定虛擬路徑的處理常式。
公用方法 Execute(String, Boolean) 在目前要求的內容中，執行指定虛擬路徑的處理常式，並指定是否清除 QueryString 和 Form 集合。
公用方法 Execute(String, TextWriter) 在目前要求的內容中，執行指定虛擬路徑的處理常式。 TextWriter 會擷取已執行處理常式的輸出。
公用方法 Execute(IHttpHandler, TextWriter, Boolean) 在目前要求的內容中，執行指定虛擬路徑的處理常式。 TextWriter 會擷取已執行處理常式的輸出，並且布林參數會指定是否要清除 QueryString 和 Form 集合。
公用方法 Execute(String, TextWriter, Boolean) 在目前要求的內容中，執行指定虛擬路徑的處理常式。 TextWriter 會擷取網頁的輸出，並且布林參數會指定是否要清除 QueryString 和 Form 集合。
受保護的方法 Finalize 允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
公用方法 GetHashCode 做為特定型別的雜湊函式。 (繼承自 Object)。
公用方法 GetLastError 傳回先前的例外狀況。
公用方法 GetType 取得目前執行個體的 Type。 (繼承自 Object)。
公用方法 HtmlDecode(String) 將 HTML 編碼字串解碼，並傳回解碼的字串。
公用方法 HtmlDecode(String, TextWriter) 將 HTML 編碼字串解碼，並送出結果輸出至 TextWriter 輸出資料流。
公用方法 HtmlEncode(String) 將字串作 HTML 編碼，並傳回編碼的字串。
公用方法 HtmlEncode(String, TextWriter) 將字串作 HTML 編碼，並送出結果輸出至 TextWriter 輸出資料流。
公用方法 MapPath 傳回在 Web 伺服器上對應至指定虛擬路徑的實體檔案路徑。
受保護的方法 MemberwiseClone 建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
公用方法 ToString 傳回表示目前物件的字串。 (繼承自 Object)。
公用方法 Transfer(String) 針對目前的要求結束目前網頁的執行，並使用指定的網頁 URL 路徑開始執行新網頁。
公用方法 Transfer(IHttpHandler, Boolean) 結束目前網頁的執行，並使用實作 IHttpHandler 介面的自訂 HTTP 處理常式開始執行新要求，以及指定是否要清除 QueryString 和 Form 集合。
公用方法 Transfer(String, Boolean) 結束目前網頁的執行，並使用指定的網頁 URL 路徑開始執行新網頁。 指定是否要清除 QueryString 和 Form 集合。
公用方法 TransferRequest(String) 執行所指定 URL 的非同步執行工作。
公用方法 TransferRequest(String, Boolean) 執行所指定 URL 的非同步執行工作，並保留查詢字串參數。
公用方法 TransferRequest(String, Boolean, String, NameValueCollection) 使用指定的 HTTP 方法與標頭執行所指定 URL 的非同步執行工作。
公用方法 UrlDecode(String) 將字串作 URL 解碼，並傳回解碼的字串。
公用方法 UrlDecode(String, TextWriter) 將 URL 中收到的 HTML 字串解碼，並送出結果輸出至 TextWriter 輸出資料流。
公用方法 UrlEncode(String) 將字串作 URL 編碼，並傳回編碼的字串。
公用方法 UrlEncode(String, TextWriter) 將字串作 URL 編碼，並送出結果輸出至 TextWriter 輸出資料流。
公用方法 UrlPathEncode 將 URL 字串的路徑部分以 URL 編碼，並傳回編碼的字串。
公用方法 靜態成員 UrlTokenDecode 使用 Base 64 數字，將 URL 字串語彙基元解碼成其對應的位元組陣列。
公用方法 靜態成員 UrlTokenEncode 將位元組陣列編碼成其對等的字串表示，該字串使用 Base 64 數字且可在 URL 上傳輸。
回頁首
備註

HttpServerUtility 類別的方法和屬性是透過 ASP.NET 所提供的內建 Server 物件公開。

範例

本主題隨附了一個含有原始程式碼的 Visual Studio 網站專案：下載 (英文)。

下列範例示範如何使用 HttpServerUtility 類別的 HtmlEncode 方法與 UrlEncode 方法。 HtmlEncode 方法可協助確保任何使用者提供的字串輸入將會在瀏覽器中呈現為靜態文字，而非可執行的指令碼或 HTML 項目。 UrlEncode 方法會將 URL 編碼，以便正確地在 HTTP 資料流中傳送。

Visual Basic

<%@ 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>
C#

<%@ 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>
版本資訊

.NET Framework

支援版本：4、3.5、3.0、2.0、1.1、1.0
平台

Windows 7, Windows Vista SP1 (含) 以後版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (不支援伺服器核心), Windows Server 2008 R2 (SP1 (含) 以後版本支援伺服器核心), Windows Server 2003 SP2

.NET Framework 並不支援各種平台的所有版本。如需支援的版本的清單，請參閱.NET Framework 系統需求。
執行緒安全
這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。
請參閱

參考

System.Web 命名空間
HttpContext