Leanpub Header

Skip to main content

Clean C#

Readable, Maintainable, Pleasurable C#

This book is free, please consider paying what you think it's worth and supporting independent authors - thanks :)
Free With Membership

With Membership

Free!

$9.99

You pay

$9.99

Author earns

$7.99
$

...Or Buy With Credits!

You can get credits monthly with a Reader Membership
PDF
EPUB
WEB
5,477
Readers
95
Pages
About

About

About the Book

This book will help you write cleaner, more maintainable, more readable, and more pleasurable C# code.

Share this book

Categories

Author

About the Author

Jason Roberts

With over 15 years experience, Jason Roberts is a former Microsoft MVP, freelance developer, writer and Pluralsight course author. He is the author of multiple books including Clean C#, and C# Tips and writes at his blog DontCodeTired.com. He is an open source contributor and the creator of FeatureToggle. In addition to enterprise software development, he has also designed and developed both Windows Phone and Windows Store apps. He holds a Bachelor of Science degree in computing and is an amateur music producer and landscape photographer.

You can contact him on Twitter as @robertsjason, at his blog DontCodeTired.com or check out his Pluralsight courses.

Contents

Table of Contents

About The Author

  1. Other Leanpub Books by Jason Roberts
  2. Keeping Software Soft
  3. C# Tips
  4. Pluralsight Courses

About this Book

Introduction

  1. What is Clean C#?
  2. Why Clean C#?
  3. Using this Book
  4. Code Samples
  5. Order
  6. Prescriptive
  7. Clean C# is a Spectrum

Comments

  1. Repeating What the Code Already Says
  2. Change Control Comments
  3. Comments as a Substitute for Self Documenting Code
  4. Commented-Out Code
  5. Pointless XML Documentation Comments
  6. Acceptable Use of Comments

Naming Things

  1. Qualities of Clean Names
  2. Expressive
  3. Accurate
  4. Suitable Length
  5. Pronounceable Names
  6. Naming Specific Items
  7. Namespaces
  8. Interfaces
  9. Classes
  10. Methods
  11. Properties
  12. Events
  13. Fields
  14. Attributes
  15. Method Parameters
  16. Variables
  17. Booleans
  18. Generic Types Parameters
  19. Enums
  20. Some General Rules

Methods

  1. Method Size and Clarity
  2. Cohesive Methods
  3. Mixing Abstraction Levels
  4. Action or Answering Methods
  5. Method Parameters
  6. Methods with Zero Parameters
  7. Methods with One Parameter
  8. Methods with Two Parameters
  9. Methods with Three Parameters
  10. Methods with More Than Three Parameters
  11. Refactoring to Reduce the Number of Parameters
  12. Params
  13. Output Parameters
  14. Named Arguments
  15. Boolean Switching Arguments
  16. Multiple Returns
  17. Code Duplication in Methods
  18. Methods with Side Effects

Structuring Programs for Readability

  1. Levels of Abstraction
  2. Method Level Abstractions

Errors and Exceptions

  1. Returning Error Codes
  2. Using Exceptions
  3. Supplied Framework Exceptions
  4. Defining Custom Exceptions
  5. Alternatives to Error Codes, Exceptions, and Returning Nulls
  6. Try Methods
  7. Special Case Design Pattern

Visual Formatting

  1. The Principle of Proximity
  2. The Principal of Similarity
  3. The Principal of Uniform Connectedness
  4. The Principal of Symmetry

Cohesion and Coupling

  1. Cohesion
  2. Coupling

Clean Tests

  1. Qualities of Good Test
  2. Execution Speed
  3. Independent and Isolated
  4. Repeatable and Reliable
  5. Valuable
  6. Resilient to Production Code Changes
  7. The Three Logical Phases of Tests
  8. The Arrange Phase
  9. The Act Phase
  10. The Assert Phase
  11. How Many Asserts?
  12. Simplifying Arrange Phase code with AutoFixture

Building On Clean Code

  1. The Single Responsibility Principle (SRP)
  2. The Open Closed Principle (OCP)
  3. The Liskov Substitution Principle (LSP)
  4. The Interface Segregation Principle (ISP)
  5. Keep It Simple Stupid (KISS)
  6. Don’t Repeat Yourself (DRY)
  7. You Aren’t Gonna Need It (YAGNI)

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

Now, this is technically risky for us, since you'll have the book or course files either way. But we're so confident in our products and services, and in our authors and readers, that we're happy to offer a full money back guarantee for everything we sell.

You can only find out how good something is by trying it, and because of our 100% money back guarantee there's literally no risk to do so!

So, there's no reason not to click the Add to Cart button, is there?

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $14 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub