14.12. Using the UriBuilder Class
Problem
You want to avoid making URI syntax errors when creating a URI.
Solution
Use the UriBuilder class to add each piece without worrying about syntax or place-ment in the string.
Building a URI programmatically can be challenging to do correctly in all instances. Using the UriBuilder can help to simplify it. For instance, if you needed to assemble an HTTP Uri that looked like this:
| http://user:password@localhost:8080/www.abc.com/homepagehtm?item=1233;html=<h1>Heading</h1>#stuff |
you would need to understand the layout of the HTTP Uri, which is this:
[scheme]://[user]:[password]@[host/authority]:[port]/[path];[params]?
[query string]#[fragment]It is very possible that information could come in that has only some of these pieces, or all of the pieces might be present. The UriBuilder allows the code to set properties for each of the components of the URI. This is great except for one small glitch. Every time you set the Query property, the UriBuilder class appends a ? to the front of the query string information. This means if code is written in this manner:
UriBuilder ub = new UriBuilder( ); ub.Query = "item=1233"; ub.Query += "html-<h1>heading</h1>";
the resulting query string looks like this, with two question marks:
??item=1233;html=<h1>heading</h1>
To correct this sad state of affairs, use the UriBuilderFix, which overloads the Query property and deals with this in a more reasonable manner. UriBuilderFix is a light wrapper for UriBuilder that cleans ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access