Cover Page
About This eBook
Halftitle Page
Title Page
Copyright Page
Dedication Page
Contents
Figures
Tables
Foreword
Foreword to the Second Edition
Foreword to the First Edition
Preface
Guideline Presentation
Language Choice and Code Examples
About This Book
Acknowledgments
About the Authors
About the Annotators
1. Introduction
1.1 Qualities of a Well-Designed Framework
2. Framework Design Fundamentals
2.1 Progressive Frameworks
2.2 Fundamental Principles of Framework Design
Summary
3. Naming Guidelines
3.1 Capitalization Conventions
3.2 General Naming Conventions
3.3 Names of Assemblies, DLLs, and Packages
3.4 Names of Namespaces
3.5 Names of Classes, Structs, and Interfaces
3.6 Names of Type Members
3.7 Naming Parameters
3.8 Naming Resources
Summary
4. Type Design Guidelines
4.1 Types and Namespaces
4.2 Choosing Between Class and Struct
4.3 Choosing Between Class and Interface
4.4 Abstract Class Design
4.5 Static Class Design
4.6 Interface Design
4.7 Struct Design
4.8 Enum Design
4.9 Nested Types
4.10 Types and Assembly Metadata
4.11 Strongly Typed Strings
Summary
5. Member Design
5.1 General Member Design Guidelines
5.2 Property Design
5.3 Constructor Design
5.4 Event Design
5.5 Field Design
5.6 Extension Methods
5.7 Operator Overloads
5.8 Parameter Design
5.9 Using Tuples in Member Signatures
Summary
6. Designing for Extensibility
6.1 Extensibility Mechanisms
6.2 Base Classes
6.3 Sealing
Summary
7. Exceptions
7.1 Exception Throwing
7.2 Choosing the Right Type of Exception to Throw
7.3 Using Standard Exception Types
7.4 Designing Custom Exceptions
7.5 Exceptions and Performance
Summary
8. Usage Guidelines
8.1 Arrays
8.2 Attributes
8.3 Collections
8.4 DateTime and DateTimeOffset
8.5 ICloneable
8.6 IComparable and IEquatable
8.7 IDisposable
8.8 Nullable
8.9 Object
8.10 Serialization
8.11 Uri
8.12 System.Xml Usage
8.13 Equality Operators
9. Common Design Patterns
9.1 Aggregate Components
9.2 The Async Patterns
9.3 Dependency Properties
9.4 Dispose Pattern
9.5 Factories
9.6 LINQ Support
9.7 Optional Feature Pattern
9.8 Covariance and Contravariance
9.9 Template Method
9.10 Timeouts
9.11 XAML Readable Types
9.12 Operating on Buffers
9.13 And in the End...
A. C# Coding Style Conventions
A.1 General Style Conventions
A.2 Naming Conventions
A.3 Comments
A.4 File Organization
B. Obsolete Guidance
B.3 Obsolete Guidance from Naming Guidelines
B.4 Obsolete Guidance from Type Design Guidelines
B.5 Obsolete Guidance from Member Design
B.7 Obsolete Guidance from Exceptions
B.8 Obsolete Guidance from Usage Guidelines
B.9 Obsolete Guidance from Common Design Patterns
C. Sample API Specification
Specification: Stopwatch
Scenarios and User Experience
Requirements
Design
Q & A
D. Breaking Changes
D.1 Modifying Assemblies
D.2 Adding Namespaces
D.3 Modifying Namespaces
D.4 Moving Types
D.5 Removing Types
D.6 Modifying Types
D.7 Adding Members
D.8 Moving Members
D.9 Removing Members
D.10 Overloading Members
D.11 Changing Member Signatures
D.12 Changing Behavior
D.13 A Final Note
Glossary
Index
Credits
Code Snippets
