Contract::EnsuresOnThrow<TException> Method (Boolean, String^)
Specifies a postcondition contract and a message to display if the condition is false for the enclosing method or property, based on the provided exception and condition.
Assembly: mscorlib (in mscorlib.dll)
public: generic<typename TException> where TException : Exception [ConditionalAttribute("CONTRACTS_FULL")] static void EnsuresOnThrow( bool condition, String^ userMessage )
Parameters
- condition
-
Type:
System::Boolean
The conditional expression to test.
- userMessage
-
Type:
System::String^
The message to display if the expression is false.
Type Parameters
- TException
The type of exception that invokes the postcondition check.
The condition parameter specifies a postcondition that is expected to be true when the enclosing method or property terminates abnormally and an exception of type TException is thrown. The message parameter specifies a message to display if the condition is false.
This method call must be at the beginning of a method or property, before any other code.
This contract is exposed to clients; therefore, it must only reference members that are at least as visible as the enclosing method.
You must use the binary rewriter for run-time enforcement of this postcondition.
If userMessage is not a constant string literal, the contract may not be understood by tools.
Available since 8
.NET Framework
Available since 4.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 4.0
Windows Phone Silverlight
Available since 8.0
Windows Phone
Available since 8.1