CodeThrowExceptionStatement Class

Definition

Namespace:

System.CodeDom

Assembly:

System.CodeDom.dll

Represents a statement that throws an exception.

public ref class CodeThrowExceptionStatement : System::CodeDom::CodeStatement

public class CodeThrowExceptionStatement : System.CodeDom.CodeStatement

type CodeThrowExceptionStatement = class
    inherit CodeStatement

Public Class CodeThrowExceptionStatement
Inherits CodeStatement

Inheritance

Object

CodeObject

CodeStatement

CodeThrowExceptionStatement

Examples

This example demonstrates using a CodeThrowExceptionStatement to throw a new System.Exception.

// This CodeThrowExceptionStatement throws a new System.Exception.
array<CodeExpression^>^temp0;
CodeThrowExceptionStatement^ throwException = gcnew CodeThrowExceptionStatement( gcnew CodeObjectCreateExpression( gcnew CodeTypeReference( System::Exception::typeid ),temp0 ) );

// A C# code generator produces the following source code for the preceeding example code:
// throw new System.Exception();

// This CodeThrowExceptionStatement throws a new System.Exception.
CodeThrowExceptionStatement throwException = new CodeThrowExceptionStatement(
    // codeExpression parameter indicates the exception to throw.
    // You must use an object create expression to new an exception here.
    new CodeObjectCreateExpression(
    // createType parameter inidicates the type of object to create.
    new CodeTypeReference(typeof(System.Exception)),
    // parameters parameter indicates the constructor parameters.
    new CodeExpression[] {} ) );

// A C# code generator produces the following source code for the preceeding example code:

// throw new System.Exception();

 ' This CodeThrowExceptionStatement throws a new System.Exception.
 ' The codeExpression parameter indicates the exception to throw.
 ' You must use an object create expression to new an exception here.
 Dim throwException As New CodeThrowExceptionStatement( _
New CodeObjectCreateExpression( _
    New CodeTypeReference(GetType(System.Exception)), _
    New CodeExpression() {}))

 ' A Visual Basic code generator produces the following source code for the preceeding example code:

 ' Throw New System.Exception

Remarks

CodeThrowExceptionStatement can represent a statement that throws an exception. The expression should be, or evaluate to, a reference to an instance of a type that derives from the Exception class.

The ToThrow property specifies the exception to throw.

Constructors

CodeThrowExceptionStatement()	Initializes a new instance of the CodeThrowExceptionStatement class.
CodeThrowExceptionStatement(CodeExpression)	Initializes a new instance of the CodeThrowExceptionStatement class with the specified exception type instance.

Properties

EndDirectives	Gets a CodeDirectiveCollection object that contains end directives. (Inherited from CodeStatement)
LinePragma	Gets or sets the line on which the code statement occurs. (Inherited from CodeStatement)
StartDirectives	Gets a CodeDirectiveCollection object that contains start directives. (Inherited from CodeStatement)
ToThrow	Gets or sets the exception to throw.
UserData	Gets the user-definable data for the current object. (Inherited from CodeObject)

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)