Flush
[mono.git] / web / asp-net
index 49f31f872d4906e455023c2072414ff1bedff82a..f22866b0b7860a5b88a6accae7f7cc86e6e3ce96 100755 (executable)
 * ASP.NET
 
-       The classes for running ASP.NET are being actively written.
-       Gaurav, Leen and Patrik have been building the classes
-       required to run ASP.NET web application as well as a small
-       embeddable web server.
-
-       Currently ASP.NET does not work, but work is underway.  If you
-       are interested in helping the effort please contact the
-       mono-list mailing list.
+       ASP.NET support is divided in two pieces:
+       <ul>
+               * Web Forms (Web Applications infrastructure).
+
+               * Web Services (the SOAP-based rpc system).
+       </ul>
+
+       Both are functional at this point, and applications like
+       "IBuySpy" run with Mono.
+
+       ASP.NET works either embedded into
+       our XSP server test server or the mod_mono Apache module.
+
+       We are now working on bug fixing and adding missing features
+       after making the whole pipeline compatible with MS.
+
+       Tim started work on the Web Services. After that, Lluis is in
+       charge and has been working hard on them as part of our
+       <a href="http://www.ximian.com/about_us/press_center/press_releases/index.html?pr=sourcegear">SourceGear</a> contract.
+       
+       Web services are now supported and there are some samples in the
+       XSP set of tests.
+
+** Hosting
+
+       ASP.NET provides a hosting interface.  Today we ship support
+       for two different hosting mechanisms:
+       <ul>
+               * <a href="#xsp">XSP</a>: A light-weight C# web server.
+
+               * <a href="#mod_mono">mod_mono</a>: An apache module
+                 that can host the Mono runtime and the ASP.NET runtime
+       </ul>
+
+<a name="xsp">
+** XSP
+
+       XSP is a simple web server written in C# that can be used to
+       run your ASP.NET applications.  The code is available from our
+       <a href="download.html">download page</a> or from the <a
+       href="anoncvs.html">Anonymous CVS</a> repository (module name:
+       xsp)/.
+       
+       This is where initial development of the .aspx/.ascx/.asax
+       compiler to C# took place. That compiler is now integrated in
+       System.Web classes mostly under System.Web.Compilation
+       namespace.  We added a new web server that works with mono and
+       MS runtime and is being used to debug our classes.  It resides
+       in xsp/server.
+
+       A couple of classes of this new server can be reused/extended
+       to make an apache module/cgi using mono (MonoWorkerRequest and
+       MonoApplicationHost).  This server also uses a couple of
+       plugins distributed with Mono to support gzip HTTP transfers.
+
+       There is also a set of .aspx pages to test the server along with
+       a few user controls under xsp/test.
+
+       You can check it out from CVS and run 'make install' to test it.
+
+<a name="mod_mono">
+* mod_mono
+
+       This Apache module is available from our <a
+       href="download.html">download page</a>. The <a href="anoncvs.html">
+       cvs</a> module name is mod_mono. It works with both 1.3 and 2.0
+       versions of the <a href="http://httpd.apache.org">apache server</a>.
+
+       It allows apache to serve ASP.NET pages.
+
+       Work is underway to improve it.
+
+** Controls
+
+       A lot of work has been put in the various classes that
+       implement the controls (UI.HtmlControls and UI.WebControls).
+       They have been coded mostly in the dark, and without being
+       able to test them in real life: Gaurav and Leen worked very
+       hard on this namespace. After that, we keep fixing bugs on
+       them.
+
+       We can now render all HtmlControls and all WebControls.
+
+       Help in making the controls better is appreciated.
+
+** ASP.NET and free controls.
+
+       We want to encourage developers to create open source controls
+       that can be used both on Mono's ASP.NET and Microsoft's ASP.NET.  
+
+** How to Help
+
+        Testing and fixing HtmlControls, WebControls and validators is an
+       easy way to help.
+
+        In the CVS module XSP you can find a small web server used for
+       testing and a directory containing sample aspx pages.
+
+        You have some documentation under doc directory and in the README
+        file of each directory. They explain how to test our System.Web.
+        Testing is really easy!
+
+       As the server also works with MS runtime, you can use it to check
+       what the expected results are.