從此不再懼怕URI編碼：JavaScript及C# URI編碼詳解

作者：Artwl 2012-03-08 15:03:49

JavaScript中編碼有三種方法:escape、encodeURI、encodeURIComponent。JavaScript中的還好，只提供了三個(gè)，C#中主要用的就有這么多，還沒有列出其他編碼(HTML)，一多就弄不明白，弄不明白就心生恐懼，心生恐懼就變得苦逼，本文就向大家詳細(xì)解釋在JavaScript及C#中如何對(duì)URI進(jìn)行編碼的方法(注：本文不涉及到其他編碼)。

混亂的URI編碼

JavaScript中編碼有三種方法:escape、encodeURI、encodeURIComponent

C#中編碼主要方法：HttpUtility.UrlEncode、Server.UrlEncode、Uri.EscapeUriString、Uri.EscapeDataString

JavaScript中的還好，只提供了三個(gè)，C#中主要用的就有這么多，還沒有列出其他編碼(HTML)，一多就弄不明白，弄不明白就心生恐懼，心生恐懼就變得苦逼，本文就向大家詳細(xì)解釋在JavaScript及C#中如何對(duì)URI進(jìn)行編碼的方法(注：本文不涉及到其他編碼)。

escape：不推薦使用

原因：eacape是BOM中的方法，只能對(duì)ASCII符號(hào)正確編碼，而encodeURI、encodeURIComponent可以對(duì)所有的Unicode符號(hào)編碼。ECMAScript v3 反對(duì)使用該方法，應(yīng)用使用 decodeURI() 和 decodeURIComponent() 替代它。

escape不編碼字符有69個(gè)：*，+，-，.，/，@，_，0-9，a-z，A-Z

encodeURI：用于對(duì)網(wǎng)址編碼(不包含參數(shù))

encodeURI不編碼字符有82個(gè)：!，#，$，&，'，(，)，*，+，,，-，.，/，:，;，=，?，@，_，~，0-9，a-z，A-Z

encodeURI就是為這個(gè)而設(shè)計(jì)的。encodeURI不對(duì)URI中的特殊字符進(jìn)行編碼，如冒號(hào)(:)、斜杠(/)。下面看個(gè)示例：

encodeURI("http://www.cnblogs.com/a file with spaces.html")  
// outputs http://www.cnblogs.com/a%20file%20with%20spaces.html

可以看到僅僅把空格替換成了20%，所以此方法可用于對(duì)網(wǎng)址進(jìn)行編碼。

由于encodeURI不對(duì)冒號(hào)(:)、斜杠(/)進(jìn)行編碼，所以如果參數(shù)(如把網(wǎng)址作為參數(shù))中包含冒號(hào)(:)、斜杠(/)，就會(huì)解析出錯(cuò)，所以此方法不能對(duì)參數(shù)進(jìn)行編碼。

encodeURIComponent:用于對(duì)網(wǎng)址參數(shù)進(jìn)行編碼

encodeURIComponent不編碼字符有71個(gè)：!， '，(，)，*，-，.，_，~，0-9，a-z，A-Z

可以看到此方法對(duì):/都進(jìn)行了編碼，所以不能用它來對(duì)網(wǎng)址進(jìn)行編碼。由于此方法對(duì)中文，空格，井號(hào)(#)，斜線(/)，冒號(hào)(:)都進(jìn)行了編碼，所以適合對(duì)URI中的參數(shù)進(jìn)行編碼。看下面的示例：

var param="博客";  
var url="http://www.cnblogs.com/?key="+encodeURIComponent(param)+"&page=1";  
console.log(url);//outputs http://www.cnblogs.com/?key=%E5%8D%9A%E5%AE%A2%E5%9B%AD&page=1

可以看到，這正是我們想要的結(jié)果(這里只對(duì)需要編碼的參數(shù)(page=1不需要編碼)進(jìn)行了編碼)。

Server.UrlEncode && HttpUtility.UrlEncode:不推薦

把這兩個(gè)放到一起說是因?yàn)檫@兩個(gè)方法在絕大多數(shù)情況下是一樣的。它們的區(qū)別是HttpUtility.UrlEncode默認(rèn)使用UTF8格式編碼，而Server.UrlEncode是使用系統(tǒng)預(yù)設(shè)格式編碼，Server.UrlEncode使用系統(tǒng)預(yù)設(shè)編碼做為參數(shù)調(diào)用HttpUtility.UrlEncode編碼，所以如果系統(tǒng)全局都用UTF8格式編碼，這兩個(gè)方法就是一樣的。

這兩個(gè)方法是怎么編碼的呢，我們來看個(gè)示例：

string url1 = "http://www.cnblogs.com/a file with spaces.html?a=1&b=博客#abc";  
Response.Write(HttpUtility.UrlEncode(url1) );  
 
//output  
http%3a%2f%2fwww.cnblogs.com%2fa+file+with+spaces.html%3fa%3d1%26b%3d%e5%8d%9a%e5%ae%a2%e5%9b%ad%23abc

由上面的例子我們可以看出，HttpUtility.UrlEncode對(duì)冒號(hào)(:)和斜杠(/)進(jìn)行了編碼，所以不能用來對(duì)網(wǎng)址進(jìn)行編碼。

那么能不能對(duì)參數(shù)進(jìn)行編碼呢，答案也是否定的。因?yàn)樵趨?shù)中空格應(yīng)該被編碼為%20而不是被HttpUtility.UrlEncode編碼為加號(hào)(+)，所以不推薦用這兩個(gè)方法對(duì)URI進(jìn)行編碼。

Uri.EscapeUriString:用于對(duì)網(wǎng)址編碼(不包含參數(shù))

我們還是用例子說話：

string url1 = "http://www.cnblogs.com/a file with spaces.html?a=1&b=博客園#abc";  
Response.Write( Uri.EscapeUriString(url1));  
//outputs:  
http://www.cnblogs.com/a%20file%20with%20spaces.html?a=1&b=%E5%8D%9A%E5%AE%A2%E5%9B%AD#abc

可以看出，Uri.EscapeUriString對(duì)空格進(jìn)行了編碼，也對(duì)中文進(jìn)行了編碼，但對(duì)冒號(hào)(:)、斜杠(/)和井號(hào)(#)未編碼，所以此方法可以用于網(wǎng)址進(jìn)行編碼，但不能對(duì)參數(shù)進(jìn)行編碼，作用類似JavaScript中的encodeURI方法。

Uri.EscapeDataString:用于對(duì)網(wǎng)址參數(shù)進(jìn)行編碼

仍然用例子說話：

string url1 = "http://www.cnblogs.com/a file with spaces.html?a=1&b=博客#abc";  
Response.Write(Uri.EscapeDataString(url1));  
//outputs:  
http%3A%2F%2Fwww.cnblogs.com%2Fa%20file%20with%20spaces.html%3Fa%3D1%26b%3D%E5%8D%9A%E5%AE%A2%E5%9B%AD%23abc

可以看出，Uri.EscapeDataString對(duì)冒號(hào)(:)、斜杠(/)、空格、中文、井號(hào)(#)都進(jìn)行了編碼，所以此方法不可以用于網(wǎng)址進(jìn)行編碼，但可以用于對(duì)參數(shù)進(jìn)行編碼，作用類似JavaScript中的encodeURIComponent方法。

小結(jié)

在JavaScript中推薦的做法是用encodeURI對(duì)URI的網(wǎng)址部分編碼，用encodeURIComponent對(duì)URI中傳遞的參數(shù)進(jìn)行編碼。

在C#中推薦的做法是用Uri.EscapeUriString對(duì)URI的網(wǎng)址部分編碼，用Uri.EscapeDataString對(duì)URI中傳遞的參數(shù)進(jìn)行編碼。

解碼部分就不說了，與編碼方法相對(duì)應(yīng)。

原文：http://www.cnblogs.com/artwl/archive/2012/03/07/2382848.html

【編輯推薦】