- ホーム
- > 洋書
- > 英文書
- > Computer / General
Full Description
Framework Design Guidelines, Second Edition, teaches developers the best practices for designing reusable libraries for the Microsoft .NET Framework. Expanded and updated for .NET 3.5, this new edition focuses on the design issues that directly affect the programmability of a class library, specifically its publicly accessible APIs.This book can improve the work of any .NET developer producing code that other developers will use. It includes copious annotations to the guidelines by thirty-five prominent architects and practitioners of the .NET Framework, providing a lively discussion of the reasons for the guidelines as well as examples of when to break those guidelines.Microsoft architects Krzysztof Cwalina and Brad Abrams teach framework design from the top down. From their significant combined experience and deep insight, you will learnThe general philosophy and fundamental principles of framework design Naming guidelines for the various parts of a framework Guidelines for the design and extending of types and members of types Issues affecting-and guidelines for ensuring-extensibility How (and how not) to design exceptions Guidelines for-and examples of-common framework design patternsGuidelines in this book are presented in four major forms: Do, Consider, Avoid, and Do not. These directives help focus attention on practices that should always be used, those that should generally be used, those that should rarely be used, and those that should never be used. Every guideline includes a discussion of its applicability, and most include a code example to help illuminate the dialogue.Framework Design Guidelines, Second Edition, is the only definitive source of best practices for managed code API development, direct from the architects themselves.Downloadable files can be found at the book's web page. Included in these files are the Designing .NET Class Libraries video series and instructional presentations by the authors on design guidelines for developing classes and components that extend the .NET Framework. A sample API specification (and other useful resources and tools are (also included.
Contents
Figures xviiTables xixForeword xxiForeword to the First Edition xxiiiPreface xxvAcknowledgments xxxiAbout the Authors xxxiiiAbout the Annotators xxxvChapter 1: Introduction 11.1: Qualities of a Well-Designed Framework 3Chapter 2: Framework Design Fundamentals 92.1: Progressive Frameworks 112.2: Fundamental Principles of Framework Design 14Chapter 3: Naming Guidelines 373.1: Capitalization Conventions 383.2: General Naming Conventions 463.3: Names of Assemblies and DLLs 543.4: Names of Namespaces 563.5: Names of Classes, Structs, and Interfaces 603.6: Names of Type Members 683.7: Naming Parameters 733.8: Naming Resources 74Chapter 4: Type Design Guidelines 774.1: Types and Namespaces 794.2: Choosing Between Class and Struct 844.3: Choosing Between Class and Interface 884.4: Abstract Class Design 954.5: Static Class Design 974.6: Interface Design 984.7: Struct Design 1014.8: Enum Design 1034.9: Nested Types 1154.10: Types and Assembly Metadata 118Chapter 5: Member Design 1215.1: General Member Design Guidelines 1215.2: Property Design 1385.3: Constructor Design 1445.4: Event Design 1535.5: Field Design 1595.6: Extension Methods 1625.7: Operator Overloads 1685.8: Parameter Design 175Chapter 6: Designing for Extensibility 1936.1: Extensibility Mechanisms 1936.2: Base Classes 2066.3: Sealing 207Chapter 7: Exceptions 2117.1: Exception Throwing 2167.2: Choosing the Right Type of Exception to Throw 2217.3: Using Standard Exception Types 2347.4: Designing Custom Exceptions 2397.5: Exceptions and Performance 240Chapter 8: Usage Guidelines 2458.1: Arrays 2458.2: Attributes 2478.3: Collections 2508.4: DateTime and DateTimeOffset 2618.5: ICloneable 2638.6: IComparable and IEquatable 2648.7: IDisposable 2668.8: Nullable 2668.9: Object 2688.10: Serialization 2748.11: Uri 2838.12: System.Xml Usage 2848.13: Equality Operators 286Chapter 9: Common Design Patterns 2899.1: Aggregate Components 2899.2: The Async Patterns 2989.3: Dependency Properties 3129.4: Dispose Pattern 3199.5: Factories 3329.6: LINQ Support 3379.7: Optional Feature Pattern 3449.8: Simulating Covariance 3489.9: Template Method 3549.10: Timeouts 3569.11: XAML Readable Types 3589.12: And in the End... 361Appendix A: C# Coding Style Conventions 363A.1: General Style Conventions 364A.2: Naming Conventions 367A.3: Comments 368A.4: File Organization 369Appendix B: Using FxCop to Enforce the Framework Design Guidelines 371B.1: What Is FxCop? 371B.2: The Evolution of FxCop 372B.3: How Does It Work? 373B.4: FxCop Guideline Coverage 374Appendix C: Sample API Specification 405Glossary 413Suggested Reading List 419Index 423
