{"id":1280,"date":"2011-10-31T10:07:45","date_gmt":"2011-10-31T09:07:45","guid":{"rendered":"http:\/\/www.itidea.nl\/?p=1280"},"modified":"2015-09-08T20:37:01","modified_gmt":"2015-09-08T18:37:01","slug":"sphttputility-vs-httputility","status":"publish","type":"post","link":"https:\/\/www.itidea.nl\/index.php\/sphttputility-vs-httputility\/","title":{"rendered":"SPHttpUtility vs HTTPUtility"},"content":{"rendered":"

Comparison between SPHttpUtility and HTTPUtility – encoding and decoding<\/h3>\n

There are different ways of encoding and decoding querystring parameters, for example by using SPHttpUtility or HttpUtility.
\nWhile programming SharePoint I always tend to use the SPHttpUtility class, but I didn’t know exactly why. Until I accidentally used the HttpUtility and SPHttpUtility at the same time:\u00a0I noticed some differences.\u00a0\u00a0<\/p>\n

Encode<\/h3>\n

SharePoint has a Utilities namespace, Microsoft.SharePoint.Utilities, which provides the SPHttpUtility class. One of the methods in this class is UrlKeyValueEncode with several overloads.
\nThe description of the method\u00a0<\/p>\n

UrlKeyValueEncode(string keyOrValueToEncode)<\/pre>\n
is ‘Encodes the specified URL query string key or value’.\u00a0<\/p>\n
The HttpUtility class in the namespace System.Web contains a method UrlEnode, also with overloads. The description of<\/p>\n
UrlEncode(string str)<\/pre>\n
is ‘Encodes a URL string’.
\nThe HttpUtility class doesn’t have a method to encode a query string key or value as UrlKeyValueEncode, but this is the best match.\u00a0\u00a0<\/p>\n
Let’s encode a space:
\nThe result while encoding with HttpUtility is ‘+’, encoding with SPHttpUtility results in a ‘%20’.<\/p>\n
One of the major differences is the casing of the encoded characters. SPHttpUtility encodes the characters uppercase, HttpUtility lowercase.
\nAnother difference can be seen in the picture below: HttpUtility doesn’t encode all characters, SPHttpUtility does:\u00a0\u00a0<\/p>\n
\"\"<\/a>\u00a0\u00a0<\/p>\n
Decode<\/h3>\n
To decode characters\u00a0the SPHttpUtility class provides the method<\/p>\n
UrlKeyValueDecode(string keyOrValueToDecode)<\/pre>\n
The couterpart of the UrlEncode method in the HttpUtility class is<\/p>\n
UrlDecode(string str)<\/pre>\n
While encoding results in different outcome, decoding doesn’t.
\nAs can be seen in the picture of the encoded characters above, HttpUtility doesn’t encode e.g. ‘(‘, ‘!’, ‘*’. When decoding these (unencoded) characters with SPHttpUtility the results stay ‘(‘, ‘!’, ‘*’. Check the pictures below.
\nEncoded with HttpUtility, decoded these characters:\u00a0\u00a0<\/p>\n
\"\"<\/a><\/p>\n
SPHttpUtility encodes characters ‘(‘, ‘!’ and ‘*’ as ‘%28’, ‘%21’ and ‘%2A’. When decoding these characters with SPHttpUtility, but also with HttpUtility, the results are the same:\u00a0\u00a0<\/p>\n
\"\"<\/a>\u00a0\u00a0<\/p>\n
Summary<\/h3>\n
Since decoding gives the same results with SPHttpUtility and HttpUtility, why bother the encoding method?\u00a0\u00a0<\/p>\n
Well, something inside me tells me SharePoint is using it somewhere internally. I didn’t figure out where, but why is the SPHttpUtility implemented if SharePoint easily could use HttpUtility?
\nBesides some feelings, the SPHttpUtility doesn’t use HttpUtility internally. When checking out the SPHttpUtility.UrlKeyValueEncode with ILSpy, the encoded values, uppercase(!), are listed is the readonly string array s_crgstrUrlHexValue.<\/p>\n
\"\"<\/a>\u00a0\u00a0<\/p>\n
Wikipedia has a definition of percent encoding (http:\/\/en.wikipedia.org\/wiki\/Percent-encoding<\/a>) :
\n‘Percent-encoding, also known as URL encoding, is a mechanism for encoding information in a Uniform Resource Identifier (URI) under certain circumstances’\u00a0\u00a0<\/p>\n
According to this article reserved characters (Reserved characters are those characters that sometimes have special meaning) must be encoded…
\nAccording to RFC 3986 reserved characters are:<\/p>\n
\"\"<\/a><\/p>\n
And encoded:
\n\"\"<\/a>\u00a0\u00a0<\/p>\n
So HttpUtility doesn’t encode the first five characters, SPHttpUtility encodes all reserved characters.\u00a0\u00a0<\/p>\n
To be compatible with 3986 standard it seems SPHttpUtility is the best option to use.<\/p>\n","protected":false},"excerpt":{"rendered":"
Comparison between SPHttpUtility and HTTPUtility – encoding and decoding There are different ways of encoding and decoding querystring parameters, for example by using SPHttpUtility or HttpUtility. While programming SharePoint I always tend to use the SPHttpUtility class, but I didn’t … Read More »<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[8],"tags":[20,42,6],"class_list":["post-1280","post","type-post","status-publish","format-standard","hentry","category-sharepoint-2010","tag-c","tag-sharepoint-2010","tag-visual-studio"],"_links":{"self":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1280","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/comments?post=1280"}],"version-history":[{"count":16,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1280\/revisions"}],"predecessor-version":[{"id":1299,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/posts\/1280\/revisions\/1299"}],"wp:attachment":[{"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/media?parent=1280"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/categories?post=1280"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.itidea.nl\/index.php\/wp-json\/wp\/v2\/tags?post=1280"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}