ASP.NET Request 物件常用屬性完整參考表

HttpRequest 類別封裝 HTTP 請求資訊，是 ASP.NET 伺服器端存取客戶端資料的核心入口。以下整理常用屬性與集合，附中文說明與使用情境，供開發快速查閱。

核心屬性分類表

實用程式碼片段

取得真實 IP（考慮 Proxy / Load Balancer）

public string GetClientIp()
{
    string ip = Request.Headers["X-Forwarded-For"] 
             ?? Request.Headers["X-Real-IP"] 
             ?? Request.UserHostAddress;
    return ip.Split(',')[0].Trim(); // X-Forwarded-For 可能有多個 IP
}

判斷行動裝置

bool isMobile = Request.Browser.IsMobileDevice;
// 或自訂 UserAgent 判斷

安全讀取參數（防 XSS）

string id = Request.QueryString["id"]; // 自動 URL 解碼
// 輸出時記得 HtmlEncode

注意事項

• Params 合併搜尋順序：QueryString → Form → Cookies → ServerVariables，同名鍵值以最先找到者為準，避免依賴它做關鍵邏輯。
• Files 需表單設 enctype="multipart/form-data"。
• ServerVariables 部分鍵需 IIS 設定（如 LOGON_USER 需啟用 Windows 驗證）。
• ASP.NET Core 使用 HttpContext.Request，API 類似但屬性名稱 PascalCase（如 Host、Method、Query）。

// 常用單行
Request.UserHostAddress        // IP
Request.Url.AbsoluteUri        // 完整 URL
Request.QueryString["id"]      // 參數
Request.Form["username"]       // 表單欄位
Request.Cookies["auth"]?.Value // Cookie 值
Request.Files["upload"]        // 上傳檔案
Request.IsSecureConnection     // 是否 HTTPS