HttpServerUtility 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
提供處理網頁請求的輔助方法。
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 串流中正確傳送。
<%@ 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 物件揭露。
屬性
| 名稱 | Description |
|---|---|
| MachineName |
取得伺服器的電腦名稱。 |
| ScriptTimeout |
以秒數計取或設定請求逾時值。 |
方法
| 名稱 | Description |
|---|---|
| ClearError() |
清除了之前的例外。 |
| CreateObject(String) |
建立一個以 COM 物件的程式識別碼(ProgID)識別的伺服器實例。 |
| CreateObject(Type) |
建立一個以物件類型識別的 COM 物件的伺服器實例。 |
| CreateObjectFromClsid(String) |
建立一個以 COM 物件的類別識別碼(CLSID)識別的伺服器實例。 |
| Equals(Object) |
判斷指定的 物件是否等於目前的物件。 (繼承來源 Object) |
| Execute(IHttpHandler, TextWriter, Boolean) |
在當前請求的情境中執行指定的虛擬路徑處理器。 A TextWriter 會擷取執行處理器的輸出,而布林參數則指定是否清除 QueryString 和 Form 集合。 |
| Execute(String, Boolean) |
在當前請求的情境中執行指定虛擬路徑的處理器,並指定是否清除 QueryString 和 Form 集合。 |
| Execute(String, TextWriter, Boolean) |
在當前請求的情境中執行指定的虛擬路徑處理器。 A TextWriter 捕捉頁面的輸出,而布林參數則指定是否清除 QueryString 和 Form 集合。 |
| Execute(String, TextWriter) |
在當前請求的情境中執行指定的虛擬路徑處理器。 A 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) |
透過自訂 HTTP 處理器實作 IHttpHandler 介面並指定是否清除 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) |
執行指定網址的非同步執行。 |
| UrlDecode(String, TextWriter) |
將接收到的 URL HTML 字串解碼,並將結果輸出傳送到輸出 TextWriter 串流。 |
| UrlDecode(String) |
URL 解碼一個字串,並回傳解碼後的字串。 |
| UrlEncode(String, TextWriter) |
URL 編碼字串並將結果傳送到 TextWriter 輸出串流。 |
| UrlEncode(String) |
URL 編碼字串並回傳編碼後的字串。 |
| UrlPathEncode(String) |
請勿使用;僅為瀏覽器相容性設計。 請使用 UrlEncode(String)。 |
| UrlTokenDecode(String) |
將 URL 字串標記解碼為其等效位元組陣列,使用以 64 進位為底。 |
| UrlTokenEncode(Byte[]) |
將位元組陣列編碼成其等效的字串表示,使用基數 64 位,該數字可用於 URL 傳輸。 |