Download Code Contracts User Manual
Transcript
• Section 5.2 describes how to migrate an existing project to take advantage of contracts. • Section 7.8 describes how to deal with test harness setup in VS2010 when the code under test is built with .NET v3.5 and the Microsoft.Contracts. dll . Contents 1 Code Contracts Library Overview 1.1 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 5 2 Contracts 2.1 Preconditions . . . . . . . . . . . . . . . . . . . 2.1.1 Legacy Requires . . . . . . . . . . . . . 2.1.2 Preconditions on automatic properties . 2.2 Postconditions . . . . . . . . . . . . . . . . . . 2.2.1 Normal Postconditions . . . . . . . . . . 2.2.2 Exceptional Postconditions . . . . . . . 2.2.3 Special Methods within Postconditions . 2.2.4 Postconditions on automatic properties 2.3 Object Invariants . . . . . . . . . . . . . . . . . 2.3.1 Invariants on Automatic Properties . . . 2.4 Assert . . . . . . . . . . . . . . . . . . . . . . . 2.5 Assume . . . . . . . . . . . . . . . . . . . . . . 2.6 EndContractBlock . . . . . . . . . . . . . . . . 2.7 Quantifiers . . . . . . . . . . . . . . . . . . . . 2.7.1 ForAll . . . . . . . . . . . . . . . . . . . 2.7.2 Exists . . . . . . . . . . . . . . . . . . . 2.8 Interface Contracts . . . . . . . . . . . . . . . . 2.9 Contracts on Abstract Methods . . . . . . . . . 2.10 Overloads on Contract Methods . . . . . . . . . 2.11 Contract Argument Validator Methods . . . . . 2.12 Contract Abbreviator Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 6 6 7 7 7 7 7 9 9 9 10 11 11 11 11 12 12 13 13 13 15 3 Contract Inheritance 3.1 Custom Parameter Validation and Inheritance . 3.2 Inheriting from Multiple Methods . . . . . . . . 3.3 Purity and Inheritance . . . . . . . . . . . . . . 3.4 Object Invariants and Inheritance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 17 17 17 17 4 Contract Attributes 4.1 ContractClass and ContractClassFor 4.2 ContractInvariantMethod . . . . . . 4.3 Pure . . . . . . . . . . . . . . . . . . 4.4 RuntimeContracts . . . . . . . . . . 4.5 ContractPublicPropertyName . . . . 4.6 ContractVerification . . . . . . . . . 4.7 ContractRuntimeIgnored . . . . . . . 4.8 ContractOption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 17 18 18 18 18 18 18 19 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 . . . . . . . .