CodeTryCatchFinallyStatement

.NET Framework クラス ライブラリ リファレンス

CodeTryCatchFinallyStatement クラス

任意の数の catch 句と、省略可能な finally ブロックを持つ try ブロックを表します。

名前空間: System.CodeDom
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
<ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)> _
Public Class CodeTryCatchFinallyStatement
    Inherits CodeStatement

Visual Basic (使用法)

Dim instance As CodeTryCatchFinallyStatement

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch)] 
public class CodeTryCatchFinallyStatement :
 CodeStatement

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
[ClassInterfaceAttribute(ClassInterfaceType::AutoDispatch)] 
public ref class CodeTryCatchFinallyStatement
 : public CodeStatement

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
/** @attribute ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) */ 
public class CodeTryCatchFinallyStatement extends
 CodeStatement

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
ClassInterfaceAttribute(ClassInterfaceType.AutoDispatch) 
public class CodeTryCatchFinallyStatement extends
 CodeStatement

解説

CodeTryCatchFinallyStatement を使用して、コードの try/catch ブロックを表すことができます。

TryStatements プロパティは、try ブロック内で実行するステートメントを格納します。CatchClauses プロパティは、キャッチした例外を処理する catch 句を格納します。FinallyStatements プロパティは、finally ブロック内で実行するステートメントを格納します。

メモ
try/catch ブロックは、すべての言語でサポートされているわけではありません。コード ジェネレータが try/catch の各ブロックをサポートしているかどうかを調べるには、GeneratorSupport.TryCatchStatements フラグを指定して Supports メソッドを呼び出します。

使用例

CodeTryCatchFinallyStatement を使用して、例外を処理するための try...catch...finally ステートメントを定義する方法については、次のコード例を参照してください。

Visual Basic

' Declares a type to contain a try...catch block.
Dim type1 As New CodeTypeDeclaration("TryCatchTest")

' Defines a method that throws an exception of type System.ApplicationException.
Dim method1 As New CodeMemberMethod()
method1.Name = "ThrowApplicationException"
method1.Statements.Add(New CodeThrowExceptionStatement( _
    New CodeObjectCreateExpression("System.ApplicationException",
 New CodePrimitiveExpression("Test Application
 Exception"))))
type1.Members.Add(method1)

' Defines a constructor that calls the ThrowApplicationException method
 from a try block.
Dim constructor1 As New
 CodeConstructor()
constructor1.Attributes = MemberAttributes.Public
type1.Members.Add(constructor1)

' Defines a try statement that calls the ThrowApplicationException method.
Dim try1 As New CodeTryCatchFinallyStatement()
try1.TryStatements.Add(New CodeMethodInvokeExpression(New
 CodeThisReferenceExpression(), "ThrowApplicationException"))
constructor1.Statements.Add(try1)

' Defines a catch clause for exceptions of type ApplicationException.
Dim catch1 As New CodeCatchClause("ex",
 New CodeTypeReference("System.ApplicationException"))
catch1.Statements.Add(New CodeCommentStatement("Handle
 any System.ApplicationException here."))
try1.CatchClauses.Add(catch1)

' Defines a catch clause for any remaining unhandled exception types.
Dim catch2 As New CodeCatchClause("ex")
catch2.Statements.Add(New CodeCommentStatement("Handle
 any other exception type here."))
try1.CatchClauses.Add(catch2)

' Defines a finally block by adding to the FinallyStatements collection.
try1.FinallyStatements.Add(New CodeCommentStatement("Handle
 any finally block statements."))

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

'    public class TryCatchTest 
'    {
'        
'        public TryCatchTest() 
'        {
'            try 
'            {
'                this.ThrowApplicationException();
'            }
'            catch (System.ApplicationException ex) 
'            {
'                // Handle any System.ApplicationException here.
'            }
'            catch (System.Exception ex) 
'            {
'                // Handle any other exception type here.
'            }
'          finally {
'                // Handle any finally block statements.
'            }
'        }
'        
'        private void ThrowApplicationException() 
'        {
'            throw new System.ApplicationException("Test Application
 Exception");
'        }
'    }

C#

// Declares a type to contain a try...catch block.
CodeTypeDeclaration type1 = new CodeTypeDeclaration("TryCatchTest");

// Defines a method that throws an exception of type System.ApplicationException.
CodeMemberMethod method1 = new CodeMemberMethod();
method1.Name = "ThrowApplicationException";
method1.Statements.Add( new CodeThrowExceptionStatement( 
    new CodeObjectCreateExpression("System.ApplicationException",
 new CodePrimitiveExpression("Test Application Exception"))
 ) );
type1.Members.Add( method1 );

// Defines a constructor that calls the ThrowApplicationException method
 from a try block.
CodeConstructor constructor1 = new CodeConstructor();
constructor1.Attributes = MemberAttributes.Public;            
type1.Members.Add( constructor1 );    
        
// Defines a try statement that calls the ThrowApplicationException
 method.
CodeTryCatchFinallyStatement try1 = new CodeTryCatchFinallyStatement();
try1.TryStatements.Add( new CodeMethodInvokeExpression( new
 CodeThisReferenceExpression(), "ThrowApplicationException" ) );
constructor1.Statements.Add( try1 );                    

// Defines a catch clause for exceptions of type ApplicationException.
CodeCatchClause catch1 = new CodeCatchClause("ex", new
 CodeTypeReference("System.ApplicationException"));
catch1.Statements.Add( new CodeCommentStatement("Handle any
 System.ApplicationException here.") );
try1.CatchClauses.Add( catch1 );

// Defines a catch clause for any remaining unhandled exception types.
CodeCatchClause catch2 = new CodeCatchClause("ex");
catch2.Statements.Add( new CodeCommentStatement("Handle any
 other exception type here.") );
try1.CatchClauses.Add( catch2 );
        
// Defines a finally block by adding to the FinallyStatements collection.
try1.FinallyStatements.Add( new CodeCommentStatement("Handle
 any finally block statements.") );
        
// A C# code generator produces the following source code for the preceeding
 example code:
    
//    public class TryCatchTest 
//    {
//        
//        public TryCatchTest() 
//        {
//            try 
//            {
//                this.ThrowApplicationException();
//            }
//            catch (System.ApplicationException ex) 
//            {
//                // Handle any System.ApplicationException here.
//            }
//            catch (System.Exception ex) 
//            {
//                // Handle any other exception type here.
//            }
//          finally {
//                // Handle any finally block statements.
//            }
//        }
//        
//        private void ThrowApplicationException() 
//        {
//            throw new System.ApplicationException("Test Application
 Exception");
//        }
//    }

C++

// Declares a type to contain a try...catch block.
CodeTypeDeclaration^ type1 = gcnew CodeTypeDeclaration( "TryCatchTest"
 );

// Defines a method that throws an exception of type System.ApplicationException.
CodeMemberMethod^ method1 = gcnew CodeMemberMethod;
method1->Name = "ThrowApplicationException";
array<CodePrimitiveExpression^>^temp = {gcnew CodePrimitiveExpression( "Test
 Application Exception" )};
method1->Statements->Add( gcnew CodeThrowExceptionStatement( gcnew CodeObjectCreateExpression(
 "System.ApplicationException",temp ) ) );
type1->Members->Add( method1 );

// Defines a constructor that calls the ThrowApplicationException method
 from a try block.
CodeConstructor^ constructor1 = gcnew CodeConstructor;
constructor1->Attributes = MemberAttributes::Public;
type1->Members->Add( constructor1 );

// Defines a try statement that calls the ThrowApplicationException
 method.
CodeTryCatchFinallyStatement^ try1 = gcnew CodeTryCatchFinallyStatement;
try1->TryStatements->Add( gcnew CodeMethodInvokeExpression( gcnew CodeThisReferenceExpression,"ThrowApplicationException",
 nullptr ) );
constructor1->Statements->Add( try1 );

// Defines a catch clause for exceptions of type ApplicationException.
CodeCatchClause^ catch1 = gcnew CodeCatchClause( "ex",gcnew CodeTypeReference(
 "System.ApplicationException" ) );
catch1->Statements->Add( gcnew CodeCommentStatement( "Handle any System.ApplicationException
 here." ) );
try1->CatchClauses->Add( catch1 );

// Defines a catch clause for any remaining unhandled exception types.
CodeCatchClause^ catch2 = gcnew CodeCatchClause( "ex" );
catch2->Statements->Add( gcnew CodeCommentStatement( "Handle any other
 exception type here." ) );
try1->CatchClauses->Add( catch2 );

// Defines a finally block by adding to the FinallyStatements collection.
try1->FinallyStatements->Add( gcnew CodeCommentStatement( "Handle any
 finally block statements." ) );

// A C# code generator produces the following source code for the preceeding
 example code:
//    public class TryCatchTest 
//    {
//        
//        public TryCatchTest() 
//        {
//            try 
//            {
//                this.ThrowApplicationException();
//            }
//            catch (System.ApplicationException ex) 
//            {
//                // Handle any System.ApplicationException here.
//            }
//            catch (System.Exception ex) 
//            {
//                // Handle any other exception type here.
//            }
//          finally {
//                // Handle any finally block statements.
//            }
//        }
//        
//        private void ThrowApplicationException() 
//        {
//            throw new System.ApplicationException("Test Application
 Exception");
//        }
//    }

J#

// Declares a type to contain a try...catch block.
CodeTypeDeclaration type1 = new CodeTypeDeclaration("TryCatchTest");
// Defines a method that throws an exception of type
// System.ApplicationException.
CodeMemberMethod method1 = new CodeMemberMethod();
method1.set_Name("ThrowApplicationException");
method1.get_Statements().Add(new 
    CodeThrowExceptionStatement(new CodeObjectCreateExpression(
    "System.ApplicationException", new CodeExpression[]
 { 
    new CodePrimitiveExpression("Test Application Exception")
 })));
type1.get_Members().Add(method1);
// Defines a constructor that calls the ThrowApplicationException 
// method from a try block.
CodeConstructor constructor1 = new CodeConstructor();
constructor1.set_Attributes(MemberAttributes.Public);
type1.get_Members().Add(constructor1);
// Defines a try statement that calls the 
// ThrowApplicationException method.
CodeTryCatchFinallyStatement try1 = new CodeTryCatchFinallyStatement();
try1.get_TryStatements().Add(new CodeMethodInvokeExpression(new
 
    CodeThisReferenceExpression(), "ThrowApplicationException", 
    new CodeExpression[] {}));
constructor1.get_Statements().Add(try1);
// Defines a catch clause for exceptions of type ApplicationException.
CodeCatchClause catch1 = new CodeCatchClause("ex", new
 
    CodeTypeReference("System.ApplicationException"));
catch1.get_Statements().Add(new CodeCommentStatement(
    "Handle any System.ApplicationException here."));
try1.get_CatchClauses().Add(catch1);
// Defines a catch clause for any remaining unhandled exception types.
CodeCatchClause catch2 = new CodeCatchClause("ex");
catch2.get_Statements().Add(new CodeCommentStatement(
    "Handle any other exception type here."));
try1.get_CatchClauses().Add(catch2);
// Defines a finally block by adding to the FinallyStatements collection.
try1.get_FinallyStatements().Add(new CodeCommentStatement(
    "Handle any finally block statements."));
// A VJ# code generator produces the following source code for the 
// preceeding example code:
//    public class TryCatchTest 
//    {
//        
//        public TryCatchTest() 
//        {
//            try {
//                this.ThrowApplicationException();
//            }
//            catch (System.ApplicationException ex) {
//                    // Handle any System.ApplicationException here.
//            }
//            catch (System.Exception ex) {
//                // Handle any other exception type here.
//            }
//          finally {
//                // Handle any finally block statements.
//            }
//        }
//        
//        private void ThrowApplicationException() 
//        {
//            throw new System.ApplicationException(
//                "Test Application Exception");
//        }
//    }

継承階層

System.Object
   System.CodeDom.CodeObject
     System.CodeDom.CodeStatement
      System.CodeDom.CodeTryCatchFinallyStatement

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CodeTryCatchFinallyStatement メンバ
System.CodeDom 名前空間

CodeTryCatchFinallyStatement コンストラクタ ()

CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。

名前空間: System.CodeDom
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New CodeTryCatchFinallyStatement

C#

public CodeTryCatchFinallyStatement ()

C++

public:
CodeTryCatchFinallyStatement ()

J#

public CodeTryCatchFinallyStatement ()

JScript

public function CodeTryCatchFinallyStatement
 ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CodeTryCatchFinallyStatement クラス
CodeTryCatchFinallyStatement メンバ
System.CodeDom 名前空間

CodeTryCatchFinallyStatement コンストラクタ (CodeStatement[], CodeCatchClause[], CodeStatement[])

try 句、catch 句、finally ステートメントなどのステートメントを指定して、CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。

名前空間: System.CodeDom
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    tryStatements As CodeStatement(), _
    catchClauses As CodeCatchClause(), _
    finallyStatements As CodeStatement() _
)

Visual Basic (使用法)

Dim tryStatements As CodeStatement()
Dim catchClauses As CodeCatchClause()
Dim finallyStatements As CodeStatement()

Dim instance As New CodeTryCatchFinallyStatement(tryStatements,
 catchClauses, finallyStatements)

C#

public CodeTryCatchFinallyStatement (
    CodeStatement[] tryStatements,
    CodeCatchClause[] catchClauses,
    CodeStatement[] finallyStatements
)

C++

public:
CodeTryCatchFinallyStatement (
    array<CodeStatement^>^ tryStatements, 
    array<CodeCatchClause^>^ catchClauses, 
    array<CodeStatement^>^ finallyStatements
)

J#

public CodeTryCatchFinallyStatement (
    CodeStatement[] tryStatements, 
    CodeCatchClause[] catchClauses, 
    CodeStatement[] finallyStatements
)

JScript

public function CodeTryCatchFinallyStatement
 (
    tryStatements : CodeStatement[], 
    catchClauses : CodeCatchClause[], 
    finallyStatements : CodeStatement[]
)

パラメータ

tryStatements

トライするステートメントを示す CodeStatement オブジェクトの配列。

catchClauses

キャッチする句を示す CodeCatchClause オブジェクトの配列。

finallyStatements

使用する finally ステートメントを示す CodeStatement オブジェクトの配列。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CodeTryCatchFinallyStatement クラス
CodeTryCatchFinallyStatement メンバ
System.CodeDom 名前空間

CodeTryCatchFinallyStatement コンストラクタ (CodeStatement[], CodeCatchClause[])

try 句および catch 句のステートメントを指定して、CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。

名前空間: System.CodeDom
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    tryStatements As CodeStatement(), _
    catchClauses As CodeCatchClause() _
)

Visual Basic (使用法)

Dim tryStatements As CodeStatement()
Dim catchClauses As CodeCatchClause()

Dim instance As New CodeTryCatchFinallyStatement(tryStatements,
 catchClauses)

C#

public CodeTryCatchFinallyStatement (
    CodeStatement[] tryStatements,
    CodeCatchClause[] catchClauses
)

C++

public:
CodeTryCatchFinallyStatement (
    array<CodeStatement^>^ tryStatements, 
    array<CodeCatchClause^>^ catchClauses
)

J#

public CodeTryCatchFinallyStatement (
    CodeStatement[] tryStatements, 
    CodeCatchClause[] catchClauses
)

JScript

public function CodeTryCatchFinallyStatement
 (
    tryStatements : CodeStatement[], 
    catchClauses : CodeCatchClause[]
)

パラメータ

tryStatements

トライするステートメントを示す CodeStatement オブジェクトの配列。

catchClauses

キャッチする句を示す CodeCatchClause オブジェクトの配列。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
CodeTryCatchFinallyStatement クラス
CodeTryCatchFinallyStatement メンバ
System.CodeDom 名前空間

CodeTryCatchFinallyStatement コンストラクタ

CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
CodeTryCatchFinallyStatement ()	CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。
CodeTryCatchFinallyStatement (CodeStatement[], CodeCatchClause[])	try 句および catch 句のステートメントを指定して、CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。
CodeTryCatchFinallyStatement (CodeStatement[], CodeCatchClause[], CodeStatement[])	try 句、catch 句、finally ステートメントなどのステートメントを指定して、CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。

参照

関連項目

CodeTryCatchFinallyStatement クラス
CodeTryCatchFinallyStatement メンバ
System.CodeDom 名前空間

CodeTryCatchFinallyStatement プロパティ

パブリック プロパティ

	名前	説明
	CatchClauses	使用する catch 句を取得します。
	EndDirectives	終了ディレクティブを含む CodeDirectiveCollection オブジェクトを取得します。 ( CodeStatement から継承されます。)
	FinallyStatements	使用する finally ステートメントを取得します。
	LinePragma	コード ステートメントのある行を取得または設定します。 ( CodeStatement から継承されます。)
	StartDirectives	開始ディレクティブを含む CodeDirectiveCollection オブジェクトを取得します。 ( CodeStatement から継承されます。)
	TryStatements	トライするステートメントを取得します。
	UserData	現在のオブジェクトのユーザー定義可能なデータを取得または設定します。 ( CodeObject から継承されます。)

参照

関連項目

CodeTryCatchFinallyStatement クラス
System.CodeDom 名前空間

CodeTryCatchFinallyStatement メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

CodeTryCatchFinallyStatement クラス
System.CodeDom 名前空間

CodeTryCatchFinallyStatement メンバ

任意の数の catch 句と、省略可能な finally ブロックを持つ try ブロックを表します。

CodeTryCatchFinallyStatement データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	CodeTryCatchFinallyStatement	オーバーロードされます。 CodeTryCatchFinallyStatement クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	CatchClauses	使用する catch 句を取得します。
	EndDirectives	終了ディレクティブを含む CodeDirectiveCollection オブジェクトを取得します。(CodeStatement から継承されます。)
	FinallyStatements	使用する finally ステートメントを取得します。
	LinePragma	コード ステートメントのある行を取得または設定します。 (CodeStatement から継承されます。)
	StartDirectives	開始ディレクティブを含む CodeDirectiveCollection オブジェクトを取得します。(CodeStatement から継承されます。)
	TryStatements	トライするステートメントを取得します。
	UserData	現在のオブジェクトのユーザー定義可能なデータを取得または設定します。(CodeObject から継承されます。)

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

CodeTryCatchFinallyStatement クラス
System.CodeDom 名前空間