HttpServerUtility 類別

參考

定義

命名空間:: System.Web

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

public ref class HttpServerUtility sealed

public sealed class HttpServerUtility

type HttpServerUtility = class

Public NotInheritable Class HttpServerUtility

繼承: Object
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)	建立物件程式設計識別項 (ProgID) 所識別之 COM 物件的伺服器執行個體。
CreateObject(Type)	建立以物件類型識別的 COM 物件的伺服器執行個體。
CreateObjectFromClsid(String)	建立以物件的類別識別項 (CLSID) 識別的 COM 物件的伺服器執行個體。
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)	使用 Base 64 數字，將 URL 字串語彙基元解碼成其對應的位元組陣列。
UrlTokenEncode(Byte[])	將位元組陣列編碼成其對等的字串表示，該字串使用 Base 64 數字且可在 URL 上傳輸。

適用於

另請參閱

HttpContext

共用方式為

HttpServerUtility 類別

定義

範例

備註

屬性

方法

適用於

另請參閱

其他資源