13.07.2015 Views

C# Language Specification - Willy .Net

C# Language Specification - Willy .Net

C# Language Specification - Willy .Net

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Table of ContentsA.2.12 Attributes.................................................................................................................................... 358A.3 Grammar extensions for unsafe code ....................................................................................................... 359B. Portability issues........................................................................................................................................... 361B.1 Undefined behavior................................................................................................................................... 361B.2 Implementation-defined behavior............................................................................................................. 361B.3 Unspecified behavior ................................................................................................................................ 362B.4 Other Issues............................................................................................................................................... 362C. Naming guidelines ........................................................................................................................................ 363C.1 Capitalization styles.................................................................................................................................. 363C.1.1 Pascal casing ................................................................................................................................ 363C.1.2 Camel casing ................................................................................................................................ 363C.1.3 All uppercase................................................................................................................................ 363C.1.4 Capitalization summary................................................................................................................ 363C.2 Word choice.............................................................................................................................................. 364C.3 Namespaces .............................................................................................................................................. 364C.4 Classes ...................................................................................................................................................... 364C.5 Interfaces................................................................................................................................................... 365C.6 Enums ....................................................................................................................................................... 365C.7 Static fields ............................................................................................................................................... 366C.8 Parameters................................................................................................................................................. 366C.9 Methods .................................................................................................................................................... 366C.10 Properties ................................................................................................................................................ 366C.11 Events...................................................................................................................................................... 367C.12 Case sensitivity ....................................................................................................................................... 367C.13 Avoiding type name confusion ............................................................................................................... 368D. Standard Library ......................................................................................................................................... 369E. Documentation Comments .......................................................................................................................... 433E.1 Introduction............................................................................................................................................... 433E.2 Recommended tags ................................................................................................................................... 434E.2.1 ................................................................................................................................................ 434E.2.2 .......................................................................................................................................... 435E.2.3 .................................................................................................................................... 435E.2.4 .................................................................................................................................. 435E.2.5 ............................................................................................................................................. 436E.2.6 ........................................................................................................................................... 437E.2.7 ....................................................................................................................................... 437E.2.8 ................................................................................................................................... 437E.2.9 ................................................................................................................................ 438E.2.10 ................................................................................................................................... 438E.2.11 .................................................................................................................................... 438E.2.12 .......................................................................................................................................... 439E.2.13 .................................................................................................................................... 439E.2.14 ................................................................................................................................. 440E.2.15 ....................................................................................................................................... 440E.3 Processing the documentation file ............................................................................................................ 440E.3.1 ID string format ............................................................................................................................ 440E.3.2 ID string examples........................................................................................................................ 441E.4 An example ............................................................................................................................................... 444E.4.1 <strong>C#</strong> source code ............................................................................................................................. 444E.4.2 Resulting XML............................................................................................................................. 446F. Index .............................................................................................................................................................. 449xiii

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!