Request.ServerVariables抓不到自定義的Http Header鍵值？

ASP.NET寫那麼久了，偶爾還是會有新鮮事發生，這件事情發生在確定傳過來的HTTP連線中，很肯定的有傳入一個名為「X_CustomizeName」的Header，然後怪事就發生了...

Request.ServerVariables抓不到自定義Header

其實ASP.NET要讀取傳入的HTTP Header有很多種方法，偏偏在這支程式中我是採用Request.ServerVariables來擷取值如下：

string cHeader =
  System.Web.HttpContext.Current.Request.ServerVariables["X_CustomizeName"] as string;

然而，這樣寫卻發生了永遠擷取不到值的窘境。因為，除了IIS認知的Header Key（IIS Server Variables）之外，ASP.NET全部會幫你添加一個名為「HTTP_」的前贅詞（prefixed）啊！只能怪自己年少輕狂不看文件...如今報應來了！就這樣在這個ASP時代就存在的老方法中栽了。

文件證明

MSDN說明：Request.ServerVariables Collection
原始碼：ServerVariableNameFromHeader

抓自定義Header正確的寫法

只要在你要擷取的KEY前面添加「HTTP_」字串即可。（幹！）

string cHeader =
  System.Web.HttpContext.Current.Request.ServerVariables["HTTP_X_CustomizeName"] as string;

除了沒加「HTTP_」前置字串抓不到之外還有更神奇的事情喔，就是你把前置字串之後的字串中有出現底線（_）改成橫槓（-）符號也抓的到喔，以上面為例寫成「HTTP_X-CustomizeName」混合在一起也是可以的，但是寫成「HTTP-X-CustomizeName」就不可以喔，啾咪～

其他擷取自定義HTTP Header的寫法

程式設計師應該很討厭這種天外飛來MagicString的寫法才對，天曉得半年後你再看程式碼怎麼可能會回憶起「HTTP_」是三小？因此建議是永遠拋棄ServerVariables這個方法，以免日後又被挖坑。

Headers Index寫法

可以改用下列寫法：

//有找到會回傳字串（或多筆逗號分隔字串），沒找到會回傳null
string cHeader =
  System.Web.HttpContext.Current.Request.Headers["X_CustomizeName"] as string;

這個寫法基本上沒啥太大的問題，但有一點要注意的是因為NameValueCollection允許鍵值重複，所以你帶入一個認知中的單一鍵值（Key）有可能會回傳多重值（Value），舉例來說：

var oNC = new System.Collections.Specialized.NameValueCollection() {
  {"A", "小明"},
  {"A", "小華"},  //鍵值重複
  {"B", "小英"},
};
Console.WriteLine(oNC["A"]);

上面這段程式在ToString時期會丟出「小明,小華」，而這可能不會是你想要的（或許也可能就是你要的）。

Headers GetValues寫法

下列這種寫法會更精準的汲取一筆

//有找到會回傳字串（或第一筆字串），沒找到會回傳NotFound（或你比較喜歡null也可以改回）
string cHeader = 
  System.Web.HttpContext.Current.Request.Headers.GetValues(Slashview.HttpHeaderKey.IpAddressDefault.ToExtensionString())?.FirstOrDefault()
  ??
  "NotFound";