JoinableTaskContext 클래스

정의

public ref class JoinableTaskContext : IDisposable, Microsoft::VisualStudio::Threading::IHangReportContributor

public class JoinableTaskContext : IDisposable, Microsoft.VisualStudio.Threading.IHangReportContributor

type JoinableTaskContext = class
    interface IHangReportContributor
    interface IDisposable

Public Class JoinableTaskContext
Implements IDisposable, IHangReportContributor

상속

Object

JoinableTaskContext

구현

IHangReportContributor IDisposable

설명

JoinableTasks를 사용하거나 상호 작용할 때 엄격하게 따라야 하는 세 가지 규칙이 있습니다. 1. 메서드에 특정 스레드 아파트 요구 사항(STA 또는 MTA)이 있는 경우 a) 비동기 서명을 사용하고 호환 스레드에서 원래 호출되지 않은 경우 해당 스레드에 비동기적으로 마샬링해야 합니다. 기본 스레드로 전환하는 권장 방법은 다음과 같습니다.

await JoinableTaskFactory.SwitchToMainThreadAsync();

b) 동기 서명을 가지고 잘못된 스레드에서 호출되면 예외를 throw합니다. 특히 다른 스레드에 작업을 동기적으로 마샬링할 수 있는 메서드는 없습니다(해당 작업이 수행되는 동안 차단). 일반적으로 동기 블록은 가능하면 피해야 합니다. 2. 이미 제공된 공용 API의 구현이 비동기 코드를 호출하고 완료를 차단해야 하는 경우 다음과 같은 간단한 패턴을 따라야 합니다.

JoinableTaskFactory.Run(async delegate {
    await SomeOperationAsync(...);
});

3. 이전에 시작된 작업을 기다리는 경우 해당 작업을 조인해야 합니다. 예를 들어 한 서비스는 나중에 동기적으로 차단될 수 있는 비동기 작업을 시작합니다.

JoinableTask longRunningAsyncWork = JoinableTaskFactory.RunAsync(async delegate {
    await SomeOperationAsync(...);
});

그런 다음 나중에 비동기 작업이 차단됩니다.

longRunningAsyncWork.Join();

또는 다음을 수행할 수 있습니다.

await longRunningAsyncWork;

그러나 비동기 작업을 시작한 직후 대기하는 경우 이 추가 단계가 필요하지 않습니다.

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

스레드 보안

이 형식은 모든 멤버에 대해 스레드로부터 안전합니다.