fixed suse links
[mono.git] / web / asp-net
1 * ASP.NET
2
3         ASP.NET support is divided in two pieces:
4         <ul>
5                 * Web Forms (Web Applications infrastructure).
6
7                 * Web Services (the SOAP-based rpc system).
8         </ul>
9
10         Both are functional at this point, and applications like
11         "IBuySpy" run with Mono.
12
13         ASP.NET works either embedded into
14         our XSP server test server or the mod_mono Apache module.
15
16         We are now working on bug fixing and adding missing features
17         after making the whole pipeline compatible with MS.
18
19         Tim started work on the Web Services. After that, Lluis is in
20         charge and has been working hard on them as part of our
21         <a href="http://www.ximian.com/about_us/press_center/press_releases/index.html?pr=sourcegear">SourceGear</a> contract.
22         
23         Web services are now supported and there are some samples in the
24         XSP set of tests.
25
26 ** Hosting
27
28         ASP.NET provides a hosting interface.  Today we ship support
29         for two different hosting mechanisms:
30         <ul>
31                 * <a href="#xsp">XSP</a>: A light-weight C# web server.
32
33                 * <a href="#mod_mono">mod_mono</a>: An apache module
34                   that can host the Mono runtime and the ASP.NET runtime
35         </ul>
36
37 <a name="xsp">
38 ** XSP
39
40         XSP is a simple web server written in C# that can be used to
41         run your ASP.NET applications.  The code is available from our
42         <a href="download.html">download page</a> or from the <a
43         href="anoncvs.html">Anonymous CVS</a> repository (module name:
44         xsp)/.
45         
46         This is where initial development of the .aspx/.ascx/.asax
47         compiler to C# took place. That compiler is now integrated in
48         System.Web classes mostly under System.Web.Compilation
49         namespace.  We added a new web server that works with mono and
50         MS runtime and is being used to debug our classes.  It resides
51         in xsp/server.
52
53         A couple of classes of this new server can be reused/extended
54         to make an apache module/cgi using mono (MonoWorkerRequest and
55         MonoApplicationHost).  This server also uses a couple of
56         plugins distributed with Mono to support gzip HTTP transfers.
57
58         There is also a set of .aspx pages to test the server along with
59         a few user controls under xsp/test.
60
61         You can check it out from CVS and run 'make install' to test it.
62
63 <a name="mod_mono">
64 * mod_mono
65
66         This Apache module is available from our <a
67         href="download.html">download page</a>. The <a href="anoncvs.html">
68         cvs</a> module name is mod_mono. It works with both 1.3 and 2.0
69         versions of the <a href="http://httpd.apache.org">apache server</a>.
70
71         It allows apache to serve ASP.NET pages.
72
73         Work is underway to improve it.
74
75 ** Controls
76
77         A lot of work has been put in the various classes that
78         implement the controls (UI.HtmlControls and UI.WebControls).
79         They have been coded mostly in the dark, and without being
80         able to test them in real life: Gaurav and Leen worked very
81         hard on this namespace. After that, we keep fixing bugs on
82         them.
83
84         We can now render all HtmlControls and all WebControls.
85
86         Help in making the controls better is appreciated.
87
88 ** ASP.NET and free controls.
89
90         We want to encourage developers to create open source controls
91         that can be used both on Mono's ASP.NET and Microsoft's ASP.NET.  
92
93 ** How to Help
94
95         Testing and fixing HtmlControls, WebControls and validators is an
96         easy way to help.
97
98         In the CVS module XSP you can find a small web server used for
99         testing and a directory containing sample aspx pages.
100
101         You have some documentation under doc directory and in the README
102         file of each directory. They explain how to test our System.Web.
103         Testing is really easy!
104
105         As the server also works with MS runtime, you can use it to check
106         what the expected results are.
107