STAThreadAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリケーションの COM スレッド モデルがシングル スレッド アパートメント (STA) であることを示します。
public ref class STAThreadAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class STAThreadAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Method)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class STAThreadAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Method)>]
type STAThreadAttribute = class
inherit Attribute[<System.AttributeUsage(System.AttributeTargets.Method)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type STAThreadAttribute = class
inherit AttributePublic NotInheritable Class STAThreadAttribute
Inherits Attribute- 継承
- 属性
注釈
この属性をエントリ ポイント メソッド (C# および Visual Basic の Main() メソッド) に適用します。 他のメソッドには影響しません。 コードで開始するスレッドのアパートメント状態を設定するには、スレッドを開始する前に Thread.SetApartmentState または Thread.TrySetApartmentState メソッドを使用します。
COM スレッド モデルは、COM 相互運用機能を使用するアプリケーションにのみ適用されます。 COM スレッド モデルは、シングル スレッド アパートメントまたはマルチスレッド アパートメントに設定できます。 アプリケーション スレッドは、スレッドが実際に COM コンポーネントを呼び出す場合にのみ COM 相互運用のために初期化されます。 COM 相互運用機能が使用されていない場合、スレッドは初期化されず、 STAThreadAttribute 属性 (存在する場合) は無効になります。
.NET Framework バージョン 2.0 以降では、COM 相互運用の既定のスレッド モデルは、次の表に示すように、アプリケーションを開発する言語によって異なります。
| Language | COM アパートメント モデル |
|---|---|
| C# | マルチスレッド アパートメント |
| C++ | マルチスレッド アパートメント |
| Visual Basic | シングル スレッド アパートメント |
これらの既定値を変更するには、 STAThreadAttribute 属性を使用してアプリケーションのスレッド モデルを設定するか、スレッドを開始する前に Thread.SetApartmentState または Thread.TrySetApartmentState メソッドを呼び出して特定のスレッドのスレッド モデルを設定します。 C++ では、 /CLRTHREADATTRIBUTE リンカー オプションを使用してアパートメント モデルを指定することもできます。
ASP.NET アプリケーションでは、@ Page ディレクティブの ASPCompat 属性を true に設定して、ページを STA スレッド プールで強制的に処理する必要があります。
STAThreadAttribute属性を使用してスレッド モデルをシングル スレッド アパートメントに明示的に設定する場合を次に示します。
Windows フォーム アプリを開発しています。 Windows フォームアプリは、クリップボードや一般的なダイアログ ボックスなどのWindowsシステム コンポーネントと通信する場合 Windows、またはドラッグ アンド ドロップ機能などのシステム機能を使用する場合は、シングル スレッドである必要があります。 C# の Windows フォーム アプリケーション テンプレートは、STAThreadAttribute 属性を C# プロジェクトに自動的に追加します。 シングル スレッド アパートメント モデルはVisual Basicの既定値であるため、属性は必要ありません。
Visual Basic ライブラリを呼び出す C# アプリを開発しています。このライブラリは、COM 相互運用機能に依存します。 シングル スレッド アパートメント モデルはVisual Basicの既定値であるため、STAThreadAttribute 属性を使用して、アプリのスレッド モデルをシングル スレッドに変更する必要があります。
アプリケーションは、シングルスレッド アパートメント モデルを使用する COM コンポーネントを呼び出します。
コンストラクター
| 名前 | 説明 |
|---|---|
| STAThreadAttribute() |
STAThreadAttribute クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| TypeId |
派生クラスで実装されている場合は、この Attributeの一意の識別子を取得します。 (継承元 Attribute) |
メソッド
| 名前 | 説明 |
|---|---|
| Equals(Object) |
このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute) |
| GetHashCode() |
このインスタンスのハッシュ コードを返します。 (継承元 Attribute) |
| GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
| IsDefaultAttribute() |
派生クラスでオーバーライドされた場合、このインスタンスの値が派生クラスの既定値であるかどうかを示します。 (継承元 Attribute) |
| Match(Object) |
派生クラスでオーバーライドされた場合、このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。 (継承元 Attribute) |
| MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
| ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| _Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) |
一連の名前を対応する一連のディスパッチ識別子に割り当てます。 (継承元 Attribute) |
| _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) |
インターフェイスの型情報を取得するために使用できるオブジェクトの型情報を取得します。 (継承元 Attribute) |
| _Attribute.GetTypeInfoCount(UInt32) |
オブジェクトが提供する型情報インターフェイスの数 (0 または 1) を取得します。 (継承元 Attribute) |
| _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) |
オブジェクトによって公開されるプロパティとメソッドへのアクセスを提供します。 (継承元 Attribute) |
