MTAThreadAttribute クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリケーションの COM スレッド モデルがマルチスレッド アパートメント (MTA) であることを示します。
public ref class MTAThreadAttribute sealed : Attribute[System.AttributeUsage(System.AttributeTargets.Method)]
public sealed class MTAThreadAttribute : Attribute[System.AttributeUsage(System.AttributeTargets.Method)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class MTAThreadAttribute : Attribute[<System.AttributeUsage(System.AttributeTargets.Method)>]
type MTAThreadAttribute = class
inherit Attribute[<System.AttributeUsage(System.AttributeTargets.Method)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type MTAThreadAttribute = class
inherit AttributePublic NotInheritable Class MTAThreadAttribute
Inherits Attribute- 継承
- 属性
注釈
この属性をエントリ ポイント メソッド (C# および Visual Basic の Main() メソッド) に適用します。 他のメソッドには影響しません。 コードで開始するスレッドのアパートメント状態を設定するには、スレッドを開始する前に Thread.SetApartmentState または Thread.TrySetApartmentState メソッドを使用します。
COM スレッド モデルは、COM 相互運用機能を使用するアプリケーションにのみ適用されます。 COM スレッド モデルは、シングル スレッド アパートメントまたはマルチスレッド アパートメントに設定できます。 アプリケーション スレッドは、スレッドが実際に COM コンポーネントを呼び出す場合にのみ COM 相互運用のために初期化されます。 COM 相互運用機能が使用されていない場合、スレッドは初期化されず、 MTAThreadAttribute 属性 (存在する場合) は無効になります。
COM 相互運用機能の既定のスレッド モデルは、次の表に示すように、アプリケーションを開発する言語によって異なります。
| Language | COM アパートメント モデル |
|---|---|
| C# | マルチスレッド アパートメント |
| C++ | マルチスレッド アパートメント |
| Visual Basic | シングル スレッド アパートメント |
これらの既定値を変更するには、 MTAThreadAttribute 属性を使用してアプリケーションのスレッド モデルを設定するか、スレッドを開始する前に Thread.SetApartmentState または Thread.TrySetApartmentState メソッドを呼び出して特定のスレッドのスレッド モデルを設定します。 C++ では、 /CLRTHREADATTRIBUTE (CLR スレッド属性の設定) リンカー オプションを使用してアパートメント モデルを指定することもできます。
MTAThreadAttribute属性を使用して、次の場合にスレッド モデルをマルチスレッド アパートメントに明示的に設定します。
- COM 相互運用機能に依存する C# ライブラリを呼び出すVisual Basic アプリを開発しています。 マルチスレッド アパートメント モデルは C# の既定値であるため、 MTAThreadAttribute 属性を使用してアプリのスレッド モデルをマルチスレッドに変更する必要があります。
- アプリケーションは、マルチスレッド アパートメント モデルを使用する COM コンポーネントを呼び出します。
コンストラクター
| 名前 | 説明 |
|---|---|
| MTAThreadAttribute() |
MTAThreadAttribute クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| 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) |
