TaskFactory<TResult>.StartNew 메서드

정의

네임스페이스:

System.Threading.Tasks

어셈블리:

System.Runtime.dll

작업을 만들고 시작합니다.

오버로드

StartNew(Func<Object,TResult>, Object, CancellationToken)	작업을 만들고 시작합니다.
StartNew(Func<Object,TResult>, Object, TaskCreationOptions)	작업을 만들고 시작합니다.
StartNew(Func<TResult>, TaskCreationOptions)	작업을 만들고 시작합니다.
StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	작업을 만들고 시작합니다.
StartNew(Func<Object,TResult>, Object)	작업을 만들고 시작합니다.
StartNew(Func<TResult>)	작업을 만들고 시작합니다.
StartNew(Func<TResult>, CancellationToken)	작업을 만들고 시작합니다.
StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	작업을 만들고 시작합니다.

StartNew(Func<Object,TResult>, Object, CancellationToken)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

매개 변수

function

Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

state

Object

function 대리자에서 사용할 데이터가 들어 있는 개체입니다.

cancellationToken

CancellationToken

새 작업에 할당할 취소 토큰입니다.

반환

Task<TResult>

시작된 작업입니다.

예외

ObjectDisposedException

cancellationToken을 만든 취소 토큰 원본이 이미 삭제되었습니다.

ArgumentNullException

function 인수가 null인 경우

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용하여 작업을 만든 다음 메서드를 호출 Start 하여 실행을 예약하는 것과 기능적으로 동일합니다.

그러나 만들기 및 일정을 구분 StartNew 해야 하는 경우가 아니면 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용

StartNew(Func<Object,TResult>, Object, TaskCreationOptions)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

매개 변수

function

Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

state

Object

function 대리자에서 사용할 데이터가 들어 있는 개체입니다.

creationOptions

TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.

반환

Task<TResult>

시작된 작업입니다.

예외

ArgumentNullException

function 인수가 null인 경우

ArgumentOutOfRangeException

creationOptions 매개 변수가 잘못된 값을 지정합니다.

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용하여 작업을 만든 다음 메서드를 호출 Start 하여 실행을 예약하는 것과 기능적으로 동일합니다.

그러나 만들기 및 일정을 구분 StartNew 해야 하는 경우가 아니면 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용

StartNew(Func<TResult>, TaskCreationOptions)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

매개 변수

function

Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

creationOptions

TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.

반환

Task<TResult>

시작된 Task<TResult>입니다.

예외

ArgumentNullException

function 인수가 null인 경우

ArgumentOutOfRangeException

creationOptions 매개 변수가 잘못된 값을 지정합니다.

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용하여 작업을 만든 다음 메서드를 호출 Start 하여 실행을 예약하는 것과 기능적으로 동일합니다.

그러나 만들기 및 일정을 구분 StartNew 해야 하는 경우가 아니면 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용

StartNew(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

매개 변수

function

Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

cancellationToken

CancellationToken

새 작업에 할당할 취소 토큰입니다.

creationOptions

TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.

scheduler

TaskScheduler

만들어진 작업을 예약하는 데 사용할 작업 스케줄러입니다.

반환

Task<TResult>

시작된 작업입니다.

예외

ObjectDisposedException

cancellationToken을 만든 취소 토큰 원본이 이미 삭제되었습니다.

ArgumentNullException

function 인수가 null인 경우

또는

scheduler 인수가 null인 경우

ArgumentOutOfRangeException

creationOptions 매개 변수가 잘못된 값을 지정합니다.

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용하여 작업을 만든 다음 메서드를 호출 Start 하여 실행을 예약하는 것과 기능적으로 동일합니다.

그러나 만들기 및 일정을 구분 StartNew 해야 하는 경우가 아니면 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용

StartNew(Func<Object,TResult>, Object)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state);

member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)

매개 변수

function

Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

state

Object

function 대리자에서 사용할 데이터가 들어 있는 개체입니다.

반환

Task<TResult>

시작된 작업입니다.

예외

ArgumentNullException

function 인수가 null인 경우

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용하여 작업을 만든 다음 메서드를 호출 Start 하여 실행을 예약하는 것과 기능적으로 동일합니다.

그러나 만들기 및 일정을 구분 StartNew 해야 하는 경우가 아니면 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용

StartNew(Func<TResult>)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function);

member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult)) As Task(Of TResult)

매개 변수

function

Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

반환

Task<TResult>

시작된 작업입니다.

예외

ArgumentNullException

function 인수가 null인 경우

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용하여 작업을 만든 다음 메서드를 호출 Start 하여 실행을 예약하는 것과 기능적으로 동일합니다.

그러나 만들기 및 일정을 구분 StartNew 해야 하는 경우가 아니면 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용

StartNew(Func<TResult>, CancellationToken)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

매개 변수

function

Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

cancellationToken

CancellationToken

새 작업에 할당할 취소 토큰입니다.

반환

Task<TResult>

시작된 작업입니다.

예외

ObjectDisposedException

cancellationToken을 만든 취소 토큰 원본이 이미 삭제되었습니다.

ArgumentNullException

function 인수가 null인 경우

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용하여 작업을 만든 다음 메서드를 호출 Start 하여 실행을 예약하는 것과 기능적으로 동일합니다.

그러나 만들기 및 일정을 구분 StartNew 해야 하는 경우가 아니면 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용

StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

Source:

FutureFactory.cs

작업을 만들고 시작합니다.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

매개 변수

function

Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.

state

Object

function 대리자에서 사용할 데이터가 들어 있는 개체입니다.

cancellationToken

CancellationToken

새 작업에 할당할 취소 토큰입니다.

creationOptions

TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.

scheduler

TaskScheduler

만들어진 작업을 예약하는 데 사용할 작업 스케줄러입니다.

반환

Task<TResult>

시작된 작업입니다.

예외

ObjectDisposedException

cancellationToken을 만든 취소 토큰 원본이 이미 삭제되었습니다.

ArgumentNullException

function 인수가 null인 경우

또는

scheduler 인수가 null인 경우

ArgumentOutOfRangeException

creationOptions 매개 변수가 잘못된 값을 지정합니다.

설명

호출 StartNew 은 생성자 중 Task<TResult> 하나를 사용한 다음 메서드를 호출 Start 하여 실행하도록 예약하여 작업을 만드는 것과 기능적으로 동일합니다.

그러나 만들기 및 예약을 구분 StartNew 해야 하지 않는 한 단순성과 성능 모두에 권장되는 방법입니다.

추가 정보

• TPL(작업 병렬 라이브러리)
• TPL과 기타 비동기 패턴 사용