SubSonic 3.0 general questions

Question

I was eagerly awaiting the release of SubSonic 3.0 to use as my low-level data layer, and now it’s out. I'm currently using the ActiveRecord templates (having tried both the repository and advanced templates) and I have one huge request and a few questions:

Request: Other than bug fixes, Rob, please spend the time to provide documentation. I don't mean five examples; I mean API complete documentation. Here's why:

I'm testing subsonic by writing ASP.NET MembershipProvider and RoleProvider classes and simple questions continually slow me up using SubSonic:

Assuming I have a class 'User' and I update/save/delete a record using

user.Save();

I need information on how to get success/failure? Do I look for an exception on failure or can I get a count of 'affected' records (old school?)

If I get an exception, which exception(s) can I expect?

I'll have more issues, but I really believe a good functional API documentation would solve the problem.

If the answer is 'read the source code', then I'm sure you're going to chase quite a few developers away from SubSonic. I really want to use the library, but the point is "use" the library, not reverse-engineer it.

Answer 1

Re "I need information on how to get success/failure? Do I look for an exception on failure or can I get a count of 'affected' records (old school?)":

If it doesn't throw an exception then it's worked.

---

Re "If I get an exception, which exception(s) can I expect?":

You can expect a DbException.