Enterprise Library Dev Guide - PREVIEW

Developer's Guide to Microsoft Enterprise Library 5.0

Aug 20, 2010 & November 11, 2010 UPDATES - Final Release

June 7, 2010 UPDATE - Release Candidate

Download link: http://entlib.codeplex.com/releases/view/46741

We are experimenting with a new style of documentation for developers, that is more conversational and task-based.
Please provide your feedback here.

Historic Previews:
June 2009: EL5_DevNotes_v3_online.pdf
Nov 2009: http://entlib.codeplex.com/releases/view/35832

Last edited Feb 4, 2011 at 12:58 AM by gmelnik, version 20


gmelnik Nov 11, 2010 at 8:57 PM 
Russian edition is available too: http://www.ecom.ru/BookItem.aspx?groupId_4=53&itemId_4=262

gmelnik Nov 11, 2010 at 8:51 PM 
VB version is available now: http://oreilly.com/catalog/0790145310699/

gmelnik Sep 1, 2010 at 1:38 AM 
No VB.NET version yet, but we are working on it right now.

rcheatha Aug 20, 2010 at 9:38 PM 
Is there a VB version? No one answered that question.

gmelnik Aug 4, 2010 at 7:38 PM 
08/04/2010 Update:
C# code samples are now posted as well. Happy studying!
- Grigori

Katie77 Jul 28, 2010 at 3:48 PM 
Are the samples discussed in the preview available anywhere?

PartialClass Jul 18, 2010 at 5:54 PM 
I note that this is the "C# Edition", will there be such thing as a VB version? I would welcome that with open arms.

I should mention I am quite partial to the conversational style of this book. The previous comment "developers who are at a level where they are serious about implementing architecture practices are most likely well beyond being dummies" may be true, but those like myself who are just beginning their exploration of architecture practices still need a launching pad and this document is a great starting place.

rcollette Jun 28, 2010 at 2:15 AM 
mrtrooney... there was no reason to denigrate my opinion vs. your own. You could have simply stated your preference without making it personal. I have an opinion and I am entitled to share it just as you are. I am not quite sure what makes you believe you represent the masses. Feedback was asked for, I provided it, and I did not get personal about it. I do not understand how saying that I think the documentation should be concise and clear goes against your own opinion, which is that you did not was to read something esoteric. However, it appears that third grade behavior along with comprehension is probably what you are accustomed to since it should be "An esoteric" rather than "a esoteric" and "suit" not "suite". I can understand why you would want "for dummies" level reading.

HintonBR Jun 12, 2010 at 12:13 AM 
Very, Very useful - much better frankly than the chm docs - I love the style and the practical approach to it - definitely a keeper!

flc45 May 6, 2010 at 1:27 AM 
太棒了,万众期待的EntLib 5.0终于发布正式版本了,但中国国内好像消息有些闭塞,只有InfoQ做出报道。

JoshuaNet May 5, 2010 at 10:56 AM 
Any ideas when the whole book will be finished?

rcaringer Apr 28, 2010 at 6:41 PM 
The cover indicates that this is a C# edition which implies other editions may be available. Are other edition on the horizon? If so, what editions are you planning and when would we see them?

JoshuaNet Mar 22, 2010 at 4:35 PM 
I hope they will be launched earlier. We just discovered the Enterprise Library and this book is just an awesome introduction.
I would even pay a few bucks for a downloadable pdf-version.

chezinho Mar 22, 2010 at 4:16 PM 
Are the other chapters being launched just with the final release?

ctavares Mar 1, 2010 at 7:04 PM 
I just fixed the download link, thanks for the report.

lostasif Mar 1, 2010 at 11:29 AM 
Try to download by clicking on the image....

PeterB Feb 10, 2010 at 12:42 AM 
Download link doesn't work.

steveculshaw Jan 22, 2010 at 10:15 AM 
I like the style, there's some much to read nowadays and I often want to do a specific "something", so this sort of guide is really useful

gmelnik Nov 13, 2009 at 12:54 AM 
We haven’t done any work on .NET 4 and VS2010 compatibility yet. Our final goal is to have the existing binary run on 3.5 SP1 and 4.0, and let you compile with VS2010 if you want to. But we’re not there yet.

The best place to post this type of comments would be under Discussions and not as feedback to the Dev Guide.

eduquint Nov 2, 2009 at 3:45 PM 
The current EntLib 5 (59326) does not compile under VS 2010 Beta 2 (48 errors, 38 warnings).

I tried recompiling and testing the DataAccessQuickStart solution under VS 2010 Beta 2, but I got 10 errors and 1 warning. An example ot the errors found is:

System.ApplicationException - Unable to located specified reference: 'H:\Users\eduquint\Downloads\Enterprise Library 5.0 - 59326\Blocks\bin\Debug\Microsoft.Practices.EnterpriseLibrary.Common.dll
H:\Users\eduquint\Downloads\Enterprise Library 5.0 - 59326\Quick Starts\Data\CS\DataAccessQuickStart\TlbImp DataAccessQuickStart

Will I be able to test EntLib 5 under VS 2010 at all?

Thanks in advance for your help.

eduquint Nov 2, 2009 at 3:39 PM 
The current EntLib 5 (59326) does not compile under VS 2010 Beta 2 (48 errors, 38 warnings). Is it the way it should be? How do I use it in the VS 2010? Should I try using the supplied dlls?

mtrooney Oct 1, 2009 at 5:08 AM 
First, there's nothing wrong with the ...for dummies style of writting. I would discourage the authors/editors from accepting the response from rcollette as any measure of what is looked for. As the documentation states, and as brix states, it is a "nightmare to implement the Enterprise Library" if you don't know where you came from, and where you are going. Meaning, If I don't look under the hood, kick the tires, and race the engine, I'll never know if it will work for me. A esoteric treament of application building blocks does not suite most of us who are trying to keep up with all the technologies, while at the same time, being flexible to accept new 'best practices'. Thanks for the effort, it does show! Compare the preview docs to the initial EntLib documentation, and it's a world of difference. This is the kind of focus Microsoft needs to provide to developers to keep them.

EricTN Jul 8, 2009 at 6:53 AM 
I've started reading the 5.0 notes preview. I'm enjoying the engaging writing style.

jdulay Jun 30, 2009 at 9:12 PM 
Very use case centric. Very perscriptive. I think this is a great format.

datapvs Jun 30, 2009 at 2:34 PM 
Super idea. To go from no knowledge to the full documentation is a bit overwhelming for newbies. A great stepping stone. If it is "... for Dummies" style - bring it on!

brix Jun 8, 2009 at 4:57 PM 
I totally welcome this kind of document ,it has been a nightmare to implement the Enterprise Library and many thanks to the support forum which has improved drastically since avanade is looking after it.

Using the Enterprise Library like everything is very easy "once you know it how" but personally and for many of my collegues we found out that it was more of a "black art" on how it should be used . This kind of document however simple and dummy for the seasoned Enterprise Library developer it will make a difference in my view. So many people gave it up as they could not make it work.

I do hope that version 5 will drastically improve the Configuration Manager and make it easier to configure multiple configuration files .
Thanks for providing this document.

jefflandry May 26, 2009 at 2:48 PM 
I haven't read the document in detail, but did read most if it through the exception handling section. Thank you for a document which places an emphasis on the "big picture" instead of the complex implemenation. While the detailed documentation is critical as one becomes more familiar with the product, it has been a great trial to get up-to-speed on the VAB and PIAB which we are starting to use extensively. The logging and exceptions would help our project greatly, but the team members doing the implementation have made the case that the learning curve on MSEL is so high that they can't make a go/no-go decision in the time they can "adequately" implement something new.

My impression of this document is that it will result in substantially greater adoption.

Final comment, while I enjoy a laugh now and then and some insight into what the thinking is at times, less cracking wise and more assumption that the reader knows what their alternatives are would make this even more useful (if much less interesting to write).

Thanks for improving the documentation.

Jeff Landry

rcollette May 15, 2009 at 2:54 PM 
I lump this into the "... for Dummies" style of writing and frankly, developers who are at a level where they are serious about implementing architecture practices are most likely well beyond being dummies. The best writing style I have ever seen in a computer book can be seen in Juval Lowy's books. English isn't even his first language from what I understand. His writing is absolutely clear and to the point. I do not need "candy store" analogies to understand clearly written documentation. Please keep this concise and clear.