Changes between Version 2 and Version 3 of WikiStart

Timestamp:

01/27/14 11:26:49 (10 years ago)

Author:

smagi

Comment:

--

WikiStart

@@ -19 +19 @@
 }
 }}}
-This declares a page that accepts a protected Int32 as the first argument, and a protected string as the second argument. By default, all types specified in an IContinuation<...> declaration will be protected, which means they cannot be changed by clients. If you wish to declare that a certain page parameter is unprotected, then you need only wrap it with Unsafe<T>. For instance, suppose the integer argument from the above example should be unprotected:
-{{{
-public class SomePage : System.Web.Page, IContinuation<Unsafe<int>, string>
-{
-  ...
-}
-}}}
+This declares a page that accepts a protected Int32 as the first argument, and a protected string as the second argument. By default, all types specified in an IContinuation<...> declaration will be protected, which means they cannot be changed by clients.
+
 Any type can appear as an argument to IContinuation<...>, not just primitive values. In fact, it's good practice in Clavis not to use primitive types since parameter names are generated from the class name by default:
 {{{
-public class SomePage : System.Web.Page, IContinuation<Unsafe<Project>, Customer>
+public class SomePage : System.Web.Page, IContinuation<Project, Customer>
 {
   ...
@@ -40 +35 @@
 }
 }}}
+
+== Unsafe Parameters ==
+
+If you wish to declare that a certain page parameter is unprotected, then you need only wrap it with Unsafe<T>. For instance, suppose the integer argument from the first example should be unprotected:
+{{{
+public class SomePage : System.Web.Page, IContinuation<Unsafe<int>, string>
+{
+  ...
+}
+}}}
 IEnumerable<T> and Unsafe<T> can also be nested, so you can have an unsafe list of objects as a parameter:
 {{{
@@ -47 +52 @@
 }
 }}}
+
+== Generating URLs ==
+
+You can easily generate a URL from a continuation with its arguments like so:
+{{{
+var url = Continuation.ToUrl<SomePage, int, string>(
+              3.AsParam(), "hello world!".AsParam());
+}}}
+The first type argument, SomePage, is the continuation type. The subsequent type arguments are the type arguments to IContinuation<...>. Another method of generating a URL that requires fewer type annotations:
+{{{
+var url = Continuation.Params(3.AsParam(), "hello world!".AsParam());
+                      .ToUrl<SomePage>();
+}}}
+The {{{Param.AsParam()}}} extension methods are fully defined over all [http://msdn.microsoft.com/en-us/library/system.iconvertible.aspx IConvertible] types. Types that aren't IConvertible require that you provide an ICovertible type as a key:
+{{{
+public class SomePage : System.Web.Page, IContinuation<Project, Customer> { ... }
+
+...
+
+var url = Continuation.Params(project.AsParam(project.Id), customer.AsParam(customer.Id));
+                      .ToUrl<SomePage>();
+}}}