O'Reilly logo

Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, Second Edition by Brad Abrams, Krzysztof Cwalina

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

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.

Image  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 ...

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required