Usage Warnings

Usage warnings support proper usage of the .NET Framework.

In This Section

• Assemblies should declare minimum security

• Call base class methods on ISerializable types

• Collection properties should be read only

• Disposable fields should be disposed

• Disposable types should declare finalizer

• Do not call overridable methods in constructors

• Do not decrease inherited member visibility

• Do not ignore method results

• Do not mark enums with FlagsAttribute

• Do not mark serviced components with WebMethod

• Do not raise exceptions in filter blocks

• Do not raise reserved exception types

• Do not ship unreleased resource formats

• Finalizers should be protected

• Finalizers should call base class finalizer

• Implement ISerializable correctly

• Implement serialization constructors

• Implement serialization methods correctly

• Initialize value type static fields inline

• Instantiate argument exceptions correctly

• Mark all non-serializable fields

• Mark ISerializable types with serializable

• Mark Windows Forms entry points with STAThread

• Members should differ by more than return type

• Non-constant fields should not be visible

• Operations should not overflow

• Operator overloads have named alternates

• Operators should have symmetrical overloads

• Override equals on overloading operator equals

• Override GetHashCode on overriding Equals

• Overload operator equals on overriding value type equals

• Pass system uri objects instead of strings

• Provide correct arguments to formatting methods

• Provide deserialization methods for optional fields

• Rethrow to preserve stack details

• Use managed equivalents of win32 api

• Use params for variable arguments