Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, Second Edition

8 Usage Guidelines

THIS CHAPTER CONTAINS guidelines for using common types in publicly accessible APIs. It deals with direct usage of built-in Framework types (e.g., Collection<T>, serialization attributes), implementing common interfaces, and inheriting from common base classes. The last section of the chapter talks about overloading common operators.

8.1 Arrays

This section presents guidelines for using arrays in publicly accessible APIs.

  DO prefer using collections over arrays in public APIs. Section 8.3.3 provides details about how to choose between collections and arrays.

public class Order {   public Collection<OrderItem> Items { get ...