
This is the Title of the Book, eMatter Edition
Copyright © 2007 O’Reilly & Associates, Inc. All rights reserved.
816
|
Chapter 14: Web
See Also
See the “EscapeUriString Method,” “EscapeUriData Method,” and “Unescape-
DataString Method” topics in the MSDN documentation.
14.14 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/home page
htm?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 proper-
ties 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"; ...