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 interop을 사용하는 애플리케이션에만 적용됩니다. COM 스레딩 모델은 단일 스레드 아파트 또는 다중 스레드 아파트로 설정할 수 있습니다. 애플리케이션 스레드는 스레드가 실제로 COM 구성 요소를 호출하는 경우에만 COM interop에 대해 초기화됩니다. COM interop을 사용하지 않으면 스레드가 초기화되지 않으며 STAThreadAttribute 특성이 있는 경우 아무런 효과가 없습니다.
.NET Framework 버전 2.0부터 COM interop의 기본 스레딩 모델은 다음 표와 같이 애플리케이션을 개발하는 언어에 따라 달라집니다.
| 언어 | COM 아파트 모델 |
|---|---|
| C# | 다중 스레드 아파트 |
| C++ | 다중 스레드 아파트 |
| Visual Basic | 단일 스레드 아파트 |
이러한 기본값을 변경하려면 특성을 사용하여 STAThreadAttribute 애플리케이션에 대한 스레딩 모델을 설정하거나 스레드를 시작하기 전에 또는 Thread.TrySetApartmentState 메서드를 호출 Thread.SetApartmentState 하여 특정 스레드에 대한 스레딩 모델을 설정합니다. C++에서는 /CLRTHREADATTRIBUTE 링커 옵션을 사용하여 아파트 모델을 지정할 수도 있습니다.
ASP.NET 애플리케이션은 @ Page 지시문의 ASPCompat 특성을 true 설정하여 STA 스레드 풀에서 페이지를 강제로 서비스해야 합니다.
다음은 특성을 사용하여 STAThreadAttribute 스레딩 모델을 단일 스레드 아파트로 명시적으로 설정하려는 몇 가지 경우입니다.
Windows Forms 앱을 개발하고 있습니다. Windows Forms 앱은 클립보드 또는 Windows 일반적인 대화 상자와 같은 Windows 시스템 구성 요소와 통신하거나 끌어서 놓기 기능과 같은 시스템 기능을 사용하는 경우 단일 스레드여야 합니다. C#용 Windows Forms 애플리케이션 템플릿은 C# 프로젝트에 STAThreadAttribute 특성을 자동으로 추가합니다. 단일 스레드 아파트 모델이 Visual Basic 기본값이므로 특성이 필요하지 않습니다.
Visual Basic 라이브러리를 호출하는 C# 앱을 개발하고 있으며, 이 앱은 COM interop에 의존합니다. 단일 스레드 아파트 모델은 Visual Basic 기본값이므로 STAThreadAttribute 특성을 사용하여 앱의 스레딩 모델을 단일 스레드로 변경해야 합니다.
애플리케이션은 단일 스레드 아파트 모델을 사용하는 COM 구성 요소를 호출합니다.
생성자
| Name | Description |
|---|---|
| STAThreadAttribute() |
STAThreadAttribute 클래스의 새 인스턴스를 초기화합니다. |
속성
| Name | Description |
|---|---|
| TypeId |
파생 클래스에서 구현되는 경우 이 Attribute대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute) |
메서드
| Name | Description |
|---|---|
| Equals(Object) |
이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute) |
| GetHashCode() |
이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute) |
| GetType() |
현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object) |
| IsDefaultAttribute() |
파생 클래스에서 재정의되는 경우 이 인스턴스의 값이 파생 클래스의 기본값인지 여부를 나타냅니다. (다음에서 상속됨 Attribute) |
| Match(Object) |
파생 클래스에서 재정의되는 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute) |
| MemberwiseClone() |
현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object) |
| ToString() |
현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object) |
명시적 인터페이스 구현
| Name | Description |
|---|---|
| _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) |
