Bagikan melalui

MTAThreadAttribute Kelas

Definisi

Ruang nama:
System
Rakitan:
mscorlib.dll, System.Runtime.dll
Rakitan:
netstandard.dll, System.Runtime.dll
Rakitan:
System.Runtime.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll
Sumber:
ThreadAttributes.cs
Sumber:
ThreadAttributes.cs
Sumber:
ThreadAttributes.cs
Sumber:
ThreadAttributes.cs
Sumber:
ThreadAttributes.cs

Menunjukkan bahwa model utas COM untuk aplikasi adalah apartemen multithreaded (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 Attribute
Public NotInheritable Class MTAThreadAttribute
Inherits Attribute
Warisan
Object
Attribute
MTAThreadAttribute
Atribut
AttributeUsageAttribute ComVisibleAttribute

Keterangan

Terapkan atribut ini ke metode titik masuk (metode Main() di C# dan Visual Basic). Ini tidak berpengaruh pada metode lain. Untuk mengatur status rangkaian apartemen yang Anda mulai dalam kode Anda, gunakan Thread.SetApartmentState metode atau Thread.TrySetApartmentState sebelum memulai utas.

Model utas COM hanya berlaku untuk aplikasi yang menggunakan interop COM. Model utas COM dapat diatur ke apartemen berulir tunggal atau apartemen multithreaded. Utas aplikasi hanya diinisialisasi untuk interop COM jika utas benar-benar melakukan panggilan ke komponen COM. Jika interop COM tidak digunakan, maka utas tidak diinisialisasi, dan MTAThreadAttribute atribut, jika ada, tidak berpengaruh.

Model utas default untuk interop COM bergantung pada bahasa tempat Anda mengembangkan aplikasi, seperti yang ditunjukkan tabel berikut.

Bahasa Model apartemen COM
C# Apartemen multithreaded
C++ Apartemen multithreaded
Visual Basic Apartemen berulir tunggal

Untuk mengubah default ini, Anda menggunakan MTAThreadAttribute atribut untuk mengatur model utas untuk aplikasi, atau memanggil Thread.SetApartmentState metode atau Thread.TrySetApartmentState sebelum memulai utas untuk mengatur model utas untuk utas tertentu. Di C++, Anda juga dapat menggunakan opsi linker /CLRTHREADATTRIBUTE (Atur Atribut Utas CLR) untuk menentukan model apartemen.

MTAThreadAttribute Gunakan atribut untuk secara eksplisit mengatur model utas ke apartemen multithread dalam kasus berikut:

  • Anda mengembangkan aplikasi Visual Basic yang memanggil pustaka C# yang pada gilirannya bergantung pada interop COM. Karena model apartemen multithreaded adalah default untuk C#, Anda harus mengubah model utas aplikasi Anda menjadi multithreaded dengan menggunakan MTAThreadAttribute atribut .
  • Aplikasi Anda melakukan panggilan ke komponen COM yang menggunakan model apartemen multithreaded.

Konstruktor

Nama Deskripsi
MTAThreadAttribute()

Menginisialisasi instans baru dari kelas MTAThreadAttribute.

Properti

Nama Deskripsi
TypeId

Ketika diimplementasikan dalam kelas turunan, mendapatkan pengidentifikasi unik untuk Attributeini.

(Diperoleh dari Attribute)

Metode

Nama Deskripsi
Equals(Object)

Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu.

(Diperoleh dari Attribute)
GetHashCode()

Mengembalikan kode hash untuk instans ini.

(Diperoleh dari Attribute)
GetType()

Mendapatkan Type instans saat ini.

(Diperoleh dari Object)
IsDefaultAttribute()

Ketika ditimpa dalam kelas turunan, menunjukkan apakah nilai instans ini adalah nilai default untuk kelas turunan.

(Diperoleh dari Attribute)
Match(Object)

Saat ditimpa dalam kelas turunan, mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek tertentu.

(Diperoleh dari Attribute)
MemberwiseClone()

Membuat salinan dangkal dari Objectsaat ini.

(Diperoleh dari Object)
ToString()

Mengembalikan string yang mewakili objek saat ini.

(Diperoleh dari Object)

Implementasi Antarmuka Eksplisit

Nama Deskripsi
_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Memetakan sekumpulan nama ke sekumpulan pengidentifikasi pengiriman yang sesuai.

(Diperoleh dari Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Mengambil informasi jenis untuk objek, yang dapat digunakan untuk mendapatkan informasi jenis untuk antarmuka.

(Diperoleh dari Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Mengambil jumlah antarmuka informasi jenis yang disediakan objek (baik 0 atau 1).

(Diperoleh dari Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Menyediakan akses ke properti dan metode yang diekspos oleh objek.

(Diperoleh dari Attribute)

Berlaku untuk

Lihat juga