ThreadStateExceptionとは何？わかりやすく解説 Weblio辞書

メソッドの呼び出しで Thread が無効な ThreadState である場合は、例外がスローされます。

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

<SerializableAttribute> _
<ComVisibleAttribute(True)> _
Public Class ThreadStateException
    Inherits SystemException

Visual Basic (使用法)

Dim instance As ThreadStateException

C#

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public class ThreadStateException : SystemException

C++

[SerializableAttribute] 
[ComVisibleAttribute(true)] 
public ref class ThreadStateException : public
 SystemException

J#

/** @attribute SerializableAttribute() */ 
/** @attribute ComVisibleAttribute(true) */ 
public class ThreadStateException extends SystemException

JScript

SerializableAttribute 
ComVisibleAttribute(true) 
public class ThreadStateException extends
 SystemException

解説

スレッドは、作成されてから終了するまで少なくとも 1 つの ThreadState 状態になります。メソッドが、スレッドの現在の状態によって要求された操作が実行できない場合、ThreadStateException をスローします。たとえば、終了したスレッドで Start を呼び出してスレッドの中断を再開しようとすると、ThreadStateException がスローされます。

ThreadStateException は、値 0x80131520 の HRESULT COR_E_THREADSTATE を使用します。

ThreadStateException のインスタンスの初期プロパティ値の一覧については、ThreadStateException コンストラクタのトピックを参照してください。

使用例

ThreadStateException がスローされる原因となるエラーの例を次に示します。

Visual Basic

Imports System
Imports System.Threading

Public Class ThreadWork
   
   Public Shared Sub DoWork()
      Console.WriteLine("Working thread...")
   End Sub 'DoWork
End Class 'ThreadWork

Class ThreadStateTest
   
   Public Shared Sub Main()
      Dim myThreadDelegate As New
 ThreadStart(AddressOf ThreadWork.DoWork)
      Dim myThread As New
 Thread(myThreadDelegate)
      myThread.Start()
      Thread.Sleep(0)
      Console.WriteLine("In main. Attempting to restart myThread.")
      Try
         myThread.Start()
      Catch e As ThreadStateException
         Console.WriteLine("Caught: {0}", e.Message)
      End Try
   End Sub 'Main
End Class 'ThreadStateTest

C#

using System;
using System.Threading;

public class ThreadWork 
{
public static void DoWork()
   {
   Console.WriteLine("Working thread..."); 
   }
}

class ThreadStateTest
{
public static void Main()
   {
   ThreadStart myThreadDelegate = new ThreadStart(ThreadWork.DoWork);
   Thread myThread = new Thread(myThreadDelegate);
   myThread.Start();
   Thread.Sleep(0);
   Console.WriteLine("In main. Attempting to restart myThread.");
   try 
      {
      myThread.Start();
      }
      catch(ThreadStateException e)
      {
      Console.WriteLine("Caught: {0}", e.Message);
      }
   }
}

C++

using namespace System;
using namespace System::Threading;
ref class ThreadWork
{
public:
   static void DoWork()
   {
      Console::WriteLine( "Working thread..." );
   }

};

int main()
{
   ThreadStart^ myThreadDelegate = gcnew ThreadStart( ThreadWork::DoWork );
   Thread^ myThread = gcnew Thread( myThreadDelegate );
   myThread->Start();
   Thread::Sleep( 0 );
   Console::WriteLine( "In main. Attempting to restart myThread." );
   try
   {
      myThread->Start();
   }
   catch ( ThreadStateException^ e ) 
   {
      Console::WriteLine( "Caught: {0}", e->Message );
   }

}

J#

import System.*;
import System.Threading.*;

public class ThreadWork
{
    public static void DoWork()
    {
        Console.WriteLine("Working thread...");
    } //DoWork
} //ThreadWork

class ThreadStateTest
{
    public static void main(String[]
 args)
    {
        ThreadStart myThreadDelegate = new ThreadStart(ThreadWork.DoWork);
        System.Threading.Thread myThread =
            new System.Threading.Thread(myThreadDelegate);
        myThread.Start();
        System.Threading.Thread.Sleep(0);
        Console.WriteLine("In main. Attempting to restart myThread.");
        try {
            myThread.Start();
        }
        catch (ThreadStateException e) {
            Console.WriteLine("Caught: {0}", e.get_Message());
        }
    } //main
} //ThreadStateTest

このコードによって、次の出力が生成されます。

 In main. Attempting to restart myThread.
     Working thread...
     Caught: Thread is running or terminated. Cannot restart.

継承階層

System.Object
   System.Exception
     System.SystemException
      System.Threading.ThreadStateException

スレッドセーフ

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ThreadStateException メンバ
System.Threading 名前空間
Thread クラス
ThreadState 列挙体
Exception
その他の技術情報
マネージスレッドとアンマネージスレッド
例外の処理とスロー

ThreadStateException クラスの新しいインスタンスを既定のプロパティを使用して初期化します。

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

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New ThreadStateException

C#

public ThreadStateException ()

C++

public:
ThreadStateException ()

J#

public ThreadStateException ()

JScript

public function ThreadStateException ()

解説

このコンストラクタは、新しいインスタンスの Message プロパティを初期化し、その値として "スレッドの現在の状態が原因で、要求された操作をそのスレッドで実行できません" などのエラーを説明するシステム提供のメッセージを指定します。このメッセージは、システムの現在のカルチャを考慮して指定します。

ThreadStateException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	null 参照 (Visual Basic では Nothing).
Message	ローカライズされたエラーメッセージ文字列。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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

シリアル化したデータを使用して、ThreadStateException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Protected Sub New ( _
    info As SerializationInfo, _
    context As StreamingContext _
)

Visual Basic (使用法)

Dim info As SerializationInfo
Dim context As StreamingContext

Dim instance As New ThreadStateException(info,
 context)

C#

protected ThreadStateException (
    SerializationInfo info,
    StreamingContext context
)

C++

protected:
ThreadStateException (
    SerializationInfo^ info, 
    StreamingContext context
)

J#

protected ThreadStateException (
    SerializationInfo info, 
    StreamingContext context
)

JScript

protected function ThreadStateException (
    info : SerializationInfo, 
    context : StreamingContext
)

パラメータ

info: スローされている例外に関するシリアル化済みオブジェクトデータを保持している SerializationInfo。

context: 転送元または転送先に関するコンテキスト情報を含んでいる StreamingContext。

解説

このコンストラクタは、逆シリアル化中に、ストリームで送信された例外オブジェクトを再構築するために呼び出されます。詳細については、「XML シリアル化および SOAP シリアル化」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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

参照

関連項目
ThreadStateException クラス
ThreadStateException メンバ
System.Threading 名前空間
その他の技術情報
XML シリアル化および SOAP シリアル化

指定したエラーメッセージと、この例外の原因である内部例外への参照を使用して、ThreadStateException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String, _
    innerException As Exception _
)

Visual Basic (使用法)

Dim message As String
Dim innerException As Exception

Dim instance As New ThreadStateException(message,
 innerException)

C#

public ThreadStateException (
    string message,
    Exception innerException
)

C++

public:
ThreadStateException (
    String^ message, 
    Exception^ innerException
)

J#

public ThreadStateException (
    String message, 
    Exception innerException
)

JScript

public function ThreadStateException (
    message : String, 
    innerException : Exception
)

パラメータ

message: 例外の原因を説明するエラーメッセージ。

innerException: 現在の例外の原因である例外。innerException パラメータが null 参照 (Visual Basic では Nothing) でない場合は、内部例外を処理する catch ブロックで現在の例外が発生します。

解説

前の例外の直接の結果としてスローされる例外については、InnerException プロパティに、前の例外への参照が格納されます。InnerException プロパティは、コンストラクタに渡されたものと同じ値を返します。InnerException プロパティによって内部例外値がコンストラクタに渡されなかった場合は、null 参照 (Visual Basic では Nothing) を返します。

ThreadStateException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	内部例外参照。
Message	エラーメッセージ文字列。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ThreadStateException クラス
ThreadStateException メンバ
System.Threading 名前空間
Exception
その他の技術情報
例外の処理とスロー

指定したエラーメッセージを使用して、ThreadStateException クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    message As String _
)

Visual Basic (使用法)

Dim message As String

Dim instance As New ThreadStateException(message)

C#

public ThreadStateException (
    string message
)

C++

public:
ThreadStateException (
    String^ message
)

J#

public ThreadStateException (
    String message
)

JScript

public function ThreadStateException (
    message : String
)

パラメータ

message: 例外の原因を説明するエラーメッセージ。

解説

このコンストラクタは、新しいインスタンスの Message プロパティを message パラメータを使用して初期化します。

ThreadStateException のインスタンスの初期プロパティ値を次の表に示します。

プロパティ	値
InnerException	null 参照 (Visual Basic では Nothing).
Message	エラーメッセージ文字列。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, 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
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

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

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

名前	説明
ThreadStateException ()	ThreadStateException クラスの新しいインスタンスを既定のプロパティを使用して初期化します。 .NET Compact Framework によってサポートされています。
ThreadStateException (String)	指定したエラーメッセージを使用して、ThreadStateException クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
ThreadStateException (SerializationInfo, StreamingContext)	シリアル化したデータを使用して、ThreadStateException クラスの新しいインスタンスを初期化します。
ThreadStateException (String, Exception)	指定したエラーメッセージと、この例外の原因である内部例外への参照を使用して、ThreadStateException クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。 ( Exception から継承されます。)
	HelpLink	例外に関連付けられているヘルプファイルへのリンクを取得または設定します。 ( Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。 ( Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。 ( Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。 ( Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコールスタックにあったフレームの文字列形式を取得します。 ( Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。 ( Exception から継承されます。)

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。 ( Exception から継承されます。)

その他の技術情報

マネージスレッドとアンマネージスレッド
例外の処理とスロー

パブリックメソッドパブリックメソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 ( Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetObjectData	派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 ( Exception から継承されます。)
	GetType	現在のインスタンスのランタイム型を取得します。 ( Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 ( Exception から継承されます。)

プロテクトメソッド

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

参照

その他の技術情報

マネージスレッドとアンマネージスレッド
例外の処理とスロー

メソッドの呼び出しで Thread が無効な ThreadState である場合は、例外がスローされます。

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

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

( プロテクトコンストラクタも参照)

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

プロテクトコンストラクタ

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

パブリックプロパティ

( プロテクトプロパティも参照)

	名前	説明
	Data	例外に関する追加のユーザー定義情報を提供するキー/値ペアのコレクションを取得します。(Exception から継承されます。)
	HelpLink	例外に関連付けられているヘルプファイルへのリンクを取得または設定します。(Exception から継承されます。)
	InnerException	現在の例外を発生させた Exception インスタンスを取得します。(Exception から継承されます。)
	Message	現在の例外を説明するメッセージを取得します。(Exception から継承されます。)
	Source	エラーの原因となったアプリケーションまたはオブジェクトの名前を取得または設定します。(Exception から継承されます。)
	StackTrace	現在の例外がスローされたときにコールスタックにあったフレームの文字列形式を取得します。(Exception から継承されます。)
	TargetSite	現在の例外をスローするメソッドを取得します。(Exception から継承されます。)

プロテクトプロパティ

	名前	説明
	HResult	特定の例外に割り当てられているコード化数値である HRESULT を取得または設定します。(Exception から継承されます。)

パブリックメソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetBaseException	派生クラスでオーバーライドされた場合、それ以後に発生する 1 つ以上の例外の主要な原因である Exception を返します。 (Exception から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetObjectData	派生クラスでオーバーライドされた場合は、その例外に関する情報を使用して SerializationInfo を設定します。 (Exception から継承されます。)
	GetType	現在のインスタンスのランタイム型を取得します。 (Exception から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の例外の文字列形式を作成して返します。 (Exception から継承されます。)

プロテクトメソッド

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

参照

その他の技術情報

マネージスレッドとアンマネージスレッド
例外の処理とスロー

ThreadStateExceptionとは？わかりやすく解説

ThreadStateException クラス

ThreadStateException コンストラクタ ()

ThreadStateException コンストラクタ (SerializationInfo, StreamingContext)

ThreadStateException コンストラクタ (String, Exception)

ThreadStateException コンストラクタ (String)

ThreadStateException コンストラクタ

関連項目

ThreadStateException プロパティ

関連項目

その他の技術情報

ThreadStateException メソッド

関連項目

その他の技術情報

ThreadStateException メンバ

関連項目

その他の技術情報

「ThreadStateException」の関連用語


	© 2025 Microsoft.All rights reserved.

ThreadStateExceptionとは？ わかりやすく解説

ThreadStateException クラス

ThreadStateException コンストラクタ ()

ThreadStateException コンストラクタ (SerializationInfo, StreamingContext)

ThreadStateException コンストラクタ (String, Exception)

ThreadStateException コンストラクタ (String)

ThreadStateException コンストラクタ

関連項目

ThreadStateException プロパティ

関連項目

その他の技術情報

ThreadStateException メソッド

関連項目

その他の技術情報

ThreadStateException メンバ

関連項目

その他の技術情報

急上昇のことば

「ThreadStateException」の関連用語

ThreadStateExceptionとは？わかりやすく解説