TaskFactory.StartNew 메서드

정의

작업을 만들고 시작합니다.Creates and starts a task.

오버로드

StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

지정된 동작 대리자, 상태, 취소 토큰, 생성 옵션 및 작업 스케줄러에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, state, cancellation token, creation options and task scheduler.

StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)

지정된 동작 대리자, 취소 토큰, 생성 옵션 및 상태에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, cancellation token, creation options and state.

StartNew(Action<Object>, Object, TaskCreationOptions)

지정된 동작 대리자, 상태 및 생성 옵션에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, state and creation options.

StartNew(Action<Object>, Object, CancellationToken)

지정된 동작 대리자, 상태 및 취소 토큰에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, state and cancellation token.

StartNew(Action, CancellationToken)

지정된 동작 대리자 및 취소 토큰에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate and cancellation token.

StartNew(Action, TaskCreationOptions)

지정된 동작 대리자 및 생성 옵션에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate and creation options.

StartNew(Action)

지정된 동작 대리자에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate.

StartNew(Action<Object>, Object)

지정된 동작 대리자 및 상태에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate and state.

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

지정된 함수 대리자, 취소 토큰, 생성 옵션 및 작업 스케줄러에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, cancellation token, creation options and task scheduler.

StartNew<TResult>(Func<TResult>)

지정된 함수 대리자에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate.

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

지정된 함수 대리자 및 상태에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate and state.

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

지정된 함수 대리자 및 취소 토큰에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate and cancellation token.

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

지정된 함수 대리자 및 생성 옵션에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate and creation options.

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

지정된 함수 대리자, 상태 및 취소 토큰에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, state and cancellation token.

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

지정된 함수 대리자, 상태 및 생성 옵션에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, state and creation options.

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

지정된 함수 대리자, 상태, 취소 토큰, 생성 옵션 및 작업 스케줄러에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, state, cancellation token, creation options and task scheduler.

설명

.NET Framework 4.5부터 Task.Run 메서드는 계산 바인딩된 작업을 시작 하는 데 권장 되는 방법입니다.Starting with the .NET Framework 4.5, the Task.Run method is the recommended way to launch a compute-bound task. StartNew장기 실행, 계산 바운드 작업을 세밀 하 게 제어 해야 하는 경우에만 메서드를 사용 합니다.Use the StartNew method only when you require fine-grained control for a long-running, compute-bound task. 여기에는 다음을 제어 하려는 시나리오가 포함 됩니다.This includes scenarios in which you want to control the following:

  • 작업 만들기 옵션입니다.Task creation options. Task.Run기본적으로 메서드에서 생성 된 작업은 옵션을 사용 하 여 만들어집니다 TaskCreationOptions.DenyChildAttach .Tasks created by the Task.Run method by default are created with the TaskCreationOptions.DenyChildAttach option. 이 동작을 재정의 하거나 다른 옵션을 제공 하려면 TaskCreationOptions StartNew 오버 로드를 호출 합니다.To override this behavior, or to provide other TaskCreationOptions options, call a StartNew overload.

  • 매개 변수를 전달 합니다.Parameter passing. 메서드의 오버 로드를 Task.Run 사용 하 여 작업 대리자에 매개 변수를 전달할 수 없습니다.The overloads of the Task.Run method do not allow you to pass a parameter to the task delegate. 메서드의 오버 로드는이 StartNew 작업을 수행 합니다.Overloads of the StartNew method do.

  • 작업 스케줄러입니다.The task scheduler. 메서드의 오버 로드는 Task.Run 기본 작업 스케줄러를 사용 합니다.The overloads of the Task.Run method use the default task scheduler. 작업 스케줄러를 제어 하려면 StartNew 매개 변수를 사용 하 여 오버 로드를 호출 scheduler 합니다.To control the task scheduler, call a StartNew overload with a scheduler parameter. 자세한 내용은 TaskScheduler를 참조하세요.For more information, see TaskScheduler.

StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

지정된 동작 대리자, 상태, 취소 토큰, 생성 옵션 및 작업 스케줄러에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, state, cancellation token, creation options and task scheduler.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);
public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);
public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);
member this.StartNew : Action<obj> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task
Public Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task

매개 변수

action
Action<Object>

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

state
Object

action 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the action delegate.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls the behavior of the created task.

scheduler
TaskScheduler

만들어진 작업을 예약하는 데 사용할 작업 스케줄러입니다.The task scheduler that is used to schedule the created task.

반환

Task

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

action이(가) null인 경우action is null.

또는-or-

scheduler이(가) null인 경우scheduler is null.

creationOptions 인수가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions argument specifies an invalid TaskCreationOptions value. 자세한 내용은 FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)에 대한 설명을 참조하십시오.For more information, see the Remarks for FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

설명

System.threading.tasks.taskfactory.startnew 호출은 해당 생성자 중 하나를 사용 하 여 작업을 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)

지정된 동작 대리자, 취소 토큰, 생성 옵션 및 상태에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, cancellation token, creation options and state.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);
public System.Threading.Tasks.Task StartNew (Action action, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);
member this.StartNew : Action * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task
Public Function StartNew (action As Action, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task

매개 변수

action
Action

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls the behavior of the created task.

scheduler
TaskScheduler

만들어진 작업을 예약하는 데 사용할 작업 스케줄러입니다.The task scheduler that is used to schedule the created task.

반환

Task

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

action이(가) null인 경우action is null.

또는-or- scheduler이(가) null인 경우scheduler is null.

creationOptions가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions specifies an invalid TaskCreationOptions value. 자세한 내용은 FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)에 대한 설명을 참조하십시오.For more information, see the Remarks for FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

설명

System.threading.tasks.taskfactory.startnew 호출은 해당 생성자 중 하나를 사용 하 여 작업을 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew(Action<Object>, Object, TaskCreationOptions)

지정된 동작 대리자, 상태 및 생성 옵션에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, state and creation options.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);
public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);
public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);
member this.StartNew : Action<obj> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task
Public Function StartNew (action As Action(Of Object), state As Object, creationOptions As TaskCreationOptions) As Task

매개 변수

action
Action<Object>

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

state
Object

action 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the action delegate.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls the behavior of the created task.

반환

Task

시작된 작업입니다.The started task.

예외

action이(가) null인 경우action is null.

creationOptions가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions specifies an invalid TaskCreationOptions value.

설명

System.threading.tasks.taskfactory.startnew 호출은 해당 생성자 중 하나를 사용 하 여 작업을 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew(Action<Object>, Object, CancellationToken)

지정된 동작 대리자, 상태 및 취소 토큰에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate, state and cancellation token.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken);
member this.StartNew : Action<obj> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken) As Task

매개 변수

action
Action<Object>

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

state
Object

action 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the action delegate.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

반환

Task

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

action이(가) null인 경우action is null.

예제

다음 예제에서는 6 자로 이루어진 단어의 배열을 정의 합니다.The following example defines an array of 6-letter words. 그런 다음 각 단어가 대리자에 게 전달 되어 Action<T> 단어를 스크램블 하 고 원래 단어와 해당 하는 버전을 표시 합니다.Each word is then passed to an Action<T> delegate, which scrambles the word and displays the original word and its scrambled version.

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      CancellationTokenSource cts = new CancellationTokenSource();
      CancellationToken token = cts.Token;
      var tasks = new List<Task>();
      Random rnd = new Random();
      Object lockObj = new Object();
      String[] words6 = { "reason", "editor", "rioter", "rental",
                          "senior", "regain", "ordain", "rained" };

      foreach (var word6 in words6)
         tasks.Add(Task.Factory.StartNew( (word) => { Char[] chars = word.ToString().ToCharArray();
                                                      double[] order = new double[chars.Length];
                                                      token.ThrowIfCancellationRequested();
                                                      bool wasZero = false;
                                                      lock (lockObj) {
                                                         for (int ctr = 0; ctr < order.Length; ctr++) {
                                                             order[ctr] = rnd.NextDouble();
                                                             if (order[ctr] == 0) {
                                                                if (! wasZero) {
                                                                   wasZero = true;
                                                                }
                                                                else {
                                                                   cts.Cancel();
                                                                }
                                                             }
                                                         }
                                                      }
                                                      token.ThrowIfCancellationRequested();
                                                      Array.Sort(order, chars);
                                                      Console.WriteLine("{0} --> {1}", word,
                                                                        new String(chars));
                                                    }, word6, token));

      try {
         Task.WaitAll(tasks.ToArray());
      }
      catch (AggregateException e) {
         foreach (var ie in e.InnerExceptions) {
            if (ie is OperationCanceledException) {
               Console.WriteLine("The word scrambling operation has been cancelled.");
               break;
            }
            else {
               Console.WriteLine(ie.GetType().Name + ": " + ie.Message);
            }
         }
      }
      finally {
         cts.Dispose();
      }
   }
}
// The example displays output like the following:
//    regain --> irnaeg
//    ordain --> rioadn
//    reason --> soearn
//    rained --> rinade
//    rioter --> itrore
//    senior --> norise
//    rental --> atnerl
//    editor --> oteird
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim cts As New CancellationTokenSource()
      Dim token As CancellationToken = cts.Token
      Dim tasks As New List(Of Task)()
      Dim rnd As New Random()
      Dim lockObj As New Object()
      Dim words6() As String = { "reason", "editor", "rioter", "rental",
                                 "senior", "regain", "ordain", "rained" }

      For Each word6 in words6
         tasks.Add(Task.Factory.StartNew( Sub(word)
                                              Dim chars() As Char = word.ToString().ToCharArray()
                                              Dim order(chars.Length - 1) As Double
                                              Dim wasZero As Boolean = False
                                              SyncLock lockObj
                                                 For ctr As Integer = 0 To order.Length - 1
                                                    order(ctr) = rnd.NextDouble()
                                                    If order(ctr) = 0 Then
                                                       If Not wasZero Then
                                                          wasZero = True
                                                       Else
                                                          cts.Cancel()
                                                       End If
                                                    End If
                                                 Next
                                              End SyncLock
                                              token.ThrowIfCancellationRequested()
                                              Array.Sort(order, chars)
                                              Console.WriteLine("{0} --> {1}", word,
                                                                new String(chars))
                                          End Sub, word6))
      Next
      Try
         Task.WaitAll(tasks.ToArray())
      Catch e As AggregateException
         For Each ie In e.InnerExceptions
            If TypeOf ie Is OperationCanceledException
               Console.WriteLine("The word scrambling operation has been cancelled.")
               Exit For
            Else
               Console.WriteLine(ie.GetType().Name + ": " + ie.Message)
            End If
         Next
      Finally
         cts.Dispose()
      End Try
   End Sub
End Module
' The example displays output like the following:
'       regain --> irnaeg
'       ordain --> rioadn
'       reason --> soearn
'       rained --> rinade
'       rioter --> itrore
'       senior --> norise
'       rental --> atnerl
'       editor --> oteird

이 예제에서는 잠금으로 보호 되는 단일 난수 생성기를 초기화 합니다.Note that the example initializes a single random number generator, which is protected by a lock. 잠금을 필요로 하려면 클래스 항목의 "System.web 클래스 및 스레드 보안"을 참조 하십시오 Random .For the need of a lock, see "The System.Random class and thread safety" in the Random class topic. 난수 생성기의 손상 가능성을 처리 하기 위해 취소 토큰이 작업에 전달 됩니다.To handle the possibility of corruption of the random number generator, a cancellation token is passed to task. 두 개의 난수의 수가 0 이면 메서드는 난수 생성기가 손상 된 것으로 가정 하 고 취소 토큰을 설정 합니다.If two random numbers equal zero, the method assumes that the random number generator is corrupted and sets the cancellation token. chars단어에 6 개의 문자가 포함 된 배열을 정렬 하기 전에 메서드는 메서드를 호출 CancellationToken.ThrowIfCancellationRequested 하 여 토큰이 취소 된 경우을 throw 합니다 OperationCanceledException .Before sorting the chars array that contains the six characters in a word, the method calls the CancellationToken.ThrowIfCancellationRequested method to throw an OperationCanceledException if the token has been canceled.

설명

System.threading.tasks.taskfactory.startnew 호출은 해당 생성자 중 하나를 사용 하 여 작업을 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew(Action, CancellationToken)

지정된 동작 대리자 및 취소 토큰에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate and cancellation token.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task StartNew (Action action, System.Threading.CancellationToken cancellationToken);
member this.StartNew : Action * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function StartNew (action As Action, cancellationToken As CancellationToken) As Task

매개 변수

action
Action

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

반환

Task

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

action이(가) null인 경우action is null.

예제

다음 예제에서는 메서드를 호출 StartNew(Action, CancellationToken) 하 여 C:\system32 디렉터리에서 파일을 반복 하는 작업을 만듭니다.The following example calls the StartNew(Action, CancellationToken) method to create a task that iterates the files in the C:\Windows\System32 directory. 람다 식은 메서드를 호출 Parallel.ForEach 하 여 각 파일에 대 한 정보를 List<T> 개체에 추가 합니다.The lambda expression calls the Parallel.ForEach method to add information about each file to a List<T> object. 루프에서 호출 하는 분리 된 각 중첩 작업은 Parallel.ForEach 취소 토큰의 상태를 확인 하 고 취소가 요청 된 경우 메서드를 호출 CancellationToken.ThrowIfCancellationRequested 합니다.Each detached nested task invoked by the Parallel.ForEach loop checks the state of the cancellation token and, if cancellation is requested, calls the CancellationToken.ThrowIfCancellationRequested method. CancellationToken.ThrowIfCancellationRequested메서드는 OperationCanceledException catch 호출 스레드가 메서드를 호출할 때 블록에서 처리 되는 예외를 throw 합니다 Task.Wait .The CancellationToken.ThrowIfCancellationRequested method throws an OperationCanceledException exception that is handled in a catch block when the calling thread calls the Task.Wait method.

using System;
using System.Collections.Generic;
using System.IO;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var tokenSource = new CancellationTokenSource();
      var token = tokenSource.Token;
      var files = new List<Tuple<string, string, long, DateTime>>();

      var t = Task.Factory.StartNew( () => { string dir = "C:\\Windows\\System32\\";
                                object obj = new Object();
                                if (Directory.Exists(dir)) {
                                   Parallel.ForEach(Directory.GetFiles(dir),
                                   f => {
                                           if (token.IsCancellationRequested)
                                              token.ThrowIfCancellationRequested();
                                           var fi = new FileInfo(f);
                                           lock(obj) {
                                              files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc));          
                                           }
                                      });
                                 }
                              }
                        , token);
      tokenSource.Cancel();
      try {
         t.Wait(); 
         Console.WriteLine("Retrieved information for {0} files.", files.Count);
      }
      catch (AggregateException e) {
         Console.WriteLine("Exception messages:");
         foreach (var ie in e.InnerExceptions)
            Console.WriteLine("   {0}: {1}", ie.GetType().Name, ie.Message);

         Console.WriteLine("\nTask status: {0}", t.Status);       
      }
      finally {
         tokenSource.Dispose();
      }
   }
}
// The example displays the following output:
//       Exception messages:
//          TaskCanceledException: A task was canceled.
//       
//       Task status: Canceled
Imports System.Collections.Generic
Imports System.IO
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim tokenSource As New CancellationTokenSource()
      Dim token As CancellationToken = tokenSource.Token
      Dim files As New List(Of Tuple(Of String, String, Long, Date))()

      Dim t As Task = Task.Factory.StartNew( Sub()
                                   Dim dir As String = "C:\Windows\System32\"
                                   Dim obj As New Object()
                                   If Directory.Exists(dir)Then
                                      Parallel.ForEach(Directory.GetFiles(dir), 
                                         Sub(f)
                                            If token.IsCancellationRequested Then
                                               token.ThrowIfCancellationRequested()
                                            End If  
                                            Dim fi As New FileInfo(f)
                                            SyncLock(obj)
                                              files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc))          
                                            End SyncLock
                                         End Sub)
                                   End If
                                End Sub, token)
      tokenSource.Cancel()
      Try
         t.Wait() 
         Console.WriteLine("Retrieved information for {0} files.", files.Count)
      Catch e As AggregateException
         Console.WriteLine("Exception messages:")
         For Each ie As Exception In e.InnerExceptions
            Console.WriteLine("   {0}:{1}", ie.GetType().Name, ie.Message)
         Next
         Console.WriteLine()
         Console.WriteLine("Task status: {0}", t.Status)       
      Finally
         tokenSource.Dispose()
      End Try
   End Sub
End Module
' The example displays the following output:
'       Exception messages:
'          TaskCanceledException: A task was canceled.
'       
'       Task status: Canceled

설명

호출은 StartNew 해당 생성자 중 하나를 사용 하 여 작업을 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 메서드를 사용 하 여 기본 매개 변수를 사용 하는 Task.Run(Action, CancellationToken) 빠른 방법으로 호출할 수 있습니다 StartNew(Action, CancellationToken) .Starting with the .NET Framework 4.5, you can use the Task.Run(Action, CancellationToken) method as a quick way to call StartNew(Action, CancellationToken) with default parameters. 그러나에 대 한 두 가지 방법의 동작에는 차이가 있습니다. Task.Run(Action, CancellationToken) 기본적으로는 옵션으로 시작 된 자식 작업을 TaskCreationOptions.AttachedToParent 현재 인스턴스에 연결 하는 것을 허용 하지 않습니다 Task StartNew(Action, CancellationToken) .Note, however, that there is a difference in behavior between the two methods regarding : Task.Run(Action, CancellationToken) by default does not allow child tasks started with the TaskCreationOptions.AttachedToParent option to attach to the current Task instance, whereas StartNew(Action, CancellationToken) does. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew(Action, TaskCreationOptions)

지정된 동작 대리자 및 생성 옵션에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate and creation options.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::Tasks::TaskCreationOptions creationOptions);
public System.Threading.Tasks.Task StartNew (Action action, System.Threading.Tasks.TaskCreationOptions creationOptions);
member this.StartNew : Action * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task
Public Function StartNew (action As Action, creationOptions As TaskCreationOptions) As Task

매개 변수

action
Action

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.>One of the enumeration values that controls the behavior of the created task>

반환

Task

시작된 작업입니다.The started task.

예외

action이(가) null인 경우action is null.

creationOptions가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions specifies an invalid TaskCreationOptions value.

설명

System.threading.tasks.taskfactory.startnew 호출은 해당 생성자 중 하나를 사용 하 여 작업을 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew(Action)

지정된 동작 대리자에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action);
public System.Threading.Tasks.Task StartNew (Action action);
member this.StartNew : Action -> System.Threading.Tasks.Task
Public Function StartNew (action As Action) As Task

매개 변수

action
Action

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

반환

Task

시작된 작업입니다.The started task.

예외

action 인수가 null인 경우The action argument is null.

예제

다음 예제에서는 메서드를 사용 하 여 StartNew(Action) Action 난수를 생성 하는 대리자를 반복 해 서 호출 하 고, 해당 값을 유니코드 코드 포인트로 해석 하 고,이를 UTF16 인코딩된 코드 단위로 변환 하 고, 결과 문자에 대 한 정보를 표시 합니다.The following example uses the StartNew(Action) method to repeatedly invoke an Action delegate that generates a random number, interprets it as a Unicode code point, converts it to a UTF16-encoded code unit, and displays information about the resulting character or characters.

using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      Random rnd = new Random();
      List<Task> tasks  = new List<Task>();
      // Execute the task 10 times.
      for (int ctr = 1; ctr <= 9; ctr++) {
         tasks.Add(Task.Factory.StartNew( () => {
                                            int utf32 = 0;
                                            lock(rnd) {
                                               // Get UTF32 value.
                                               utf32 = rnd.Next(0, 0xE01F0);
                                            }
                                            // Convert it to a UTF16-encoded character.
                                            string utf16 = Char.ConvertFromUtf32(utf32);
                                            // Display information about the character.
                                            Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})", 
                                                              utf32, utf16, ShowHex(utf16));
                                         }));                           
      }
      Task.WaitAll(tasks.ToArray()); 
   }

   private static string ShowHex(string value)
   {
      string hexString = null;
      // Handle only non-control characters.
      if (! Char.IsControl(value, 0)) {
         foreach (var ch in value)
            hexString += String.Format("0x{0} ", Convert.ToUInt16(ch));
      }   
      return hexString.Trim();
   }
}
// The example displays the following output:
//       0x00097103 --> '򗄃' (0x55836 0x56579)
//       0x000A98A1 --> '򩢡' (0x55910 0x56481)
//       0x00050002 --> '񐀂' (0x55552 0x56322)
//       0x0000FEF1 --> 'ﻱ' (0x65265)
//       0x0008BC0A --> '򋰊' (0x55791 0x56330)
//       0x000860EA --> '򆃪' (0x55768 0x56554)
//       0x0009AC5A --> '򚱚' (0x55851 0x56410)
//       0x00053320 --> '񓌠' (0x55564 0x57120)
//       0x000874EF --> '򇓯' (0x55773 0x56559)
Imports System.Collections.Generic
Imports System.Threading.Tasks

Public Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim tasks As New List(Of Task)
      ' Execute the task 10 times.
      For ctr As Integer = 1 To 9
         tasks.Add(Task.Factory.StartNew(Sub()
                                            Dim utf32 As Integer
                                            SyncLock(rnd)
                                               ' Get UTF32 value.
                                               utf32 = rnd.Next(0, &hE01F0)
                                            End SyncLock
                                            ' Convert it to a UTF16-encoded character.
                                            Dim utf16 As String = Char.ConvertFromUtf32(utf32)
                                            ' Display information about the character.
                                            Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})", 
                                                              utf32, utf16, ShowHex(utf16))
                                         End Sub))                           
      Next
      Task.WaitAll(tasks.ToArray()) 
   End Sub
   
   Private Function ShowHex(value As String) As String
      Dim hexString As String = Nothing
      ' Handle only non-control characters.
      If Not Char.IsControl(value, 0) Then
         For Each ch In value
            hexString += String.Format("0x{0} ", Convert.ToUInt16(ch))
         Next
      End If   
      Return hexString.Trim()
   End Function
End Module
' The example displays output similar to the following:
'       0x00097103 --> '򗄃' (0x55836 0x56579)
'       0x000A98A1 --> '򩢡' (0x55910 0x56481)
'       0x00050002 --> '񐀂' (0x55552 0x56322)
'       0x0000FEF1 --> 'ﻱ' (0x65265)
'       0x0008BC0A --> '򋰊' (0x55791 0x56330)
'       0x000860EA --> '򆃪' (0x55768 0x56554)
'       0x0009AC5A --> '򚱚' (0x55851 0x56410)
'       0x00053320 --> '񓌠' (0x55564 0x57120)
'       0x000874EF --> '򇓯' (0x55773 0x56559)

설명

호출은 StartNew 해당 생성자 중 하나를 사용 하 여 작업을 만든 다음 메서드를 호출 하 여 실행할 작업을 예약 하는 것과 기능적으로 동일 Task.Start 합니다.Calling StartNew is functionally equivalent to creating a task by using one of its constructors, and then calling the Task.Start method to schedule the task for execution.

.NET Framework 4.5부터 메서드를 사용 하 여 기본 매개 변수를 사용 하는 Task.Run(Action) 빠른 방법으로 호출할 수 있습니다 StartNew(Action) .Starting with the .NET Framework 4.5, you can use the Task.Run(Action) method as a quick way to call StartNew(Action) with default parameters. 그러나에 대 한 두 가지 방법의 동작에는 차이가 있습니다. Task.Run(Action) 기본적으로는 옵션으로 시작 된 자식 작업을 TaskCreationOptions.AttachedToParent 현재 인스턴스에 연결 하는 것을 허용 하지 않습니다 Task StartNew(Action) .Note, however, that there is a difference in behavior between the two methods regarding : Task.Run(Action) by default does not allow child tasks started with the TaskCreationOptions.AttachedToParent option to attach to the current Task instance, whereas StartNew(Action) does. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew(Action<Object>, Object)

지정된 동작 대리자 및 상태에 대한 작업을 만들고 시작합니다.Creates and starts a task for the specified action delegate and state.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state);
public System.Threading.Tasks.Task StartNew (Action<object> action, object state);
public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state);
member this.StartNew : Action<obj> * obj -> System.Threading.Tasks.Task
Public Function StartNew (action As Action(Of Object), state As Object) As Task

매개 변수

action
Action<Object>

비동기적으로 실행할 동작 대리자입니다.The action delegate to execute asynchronously.

state
Object

action 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the action delegate.

반환

Task

시작된 작업입니다.The started task.

예외

action 인수가 null인 경우The action argument is null.

예제

다음 예제에서는 6 자로 이루어진 단어의 배열을 정의 합니다.The following example defines an array of 6-letter words. 그런 다음 각 단어가 대리자에 게 전달 되어 Action<T> 단어를 스크램블 하 고 원래 단어와 해당 하는 버전을 표시 합니다.Each word is then passed to an Action<T> delegate, which scrambles the word and displays the original word and its scrambled version.

using System;
using System.Collections.Generic;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var tasks = new List<Task>();
      Random rnd = new Random();
      Object lockObj = new Object();
      String[] words6 = { "reason", "editor", "rioter", "rental",
                          "senior", "regain", "ordain", "rained" };

      foreach (var word6 in words6)
         tasks.Add(Task.Factory.StartNew( (word) => { Char[] chars = word.ToString().ToCharArray();
                                                      double[] order = new double[chars.Length];
                                                      lock (lockObj) {
                                                         for (int ctr = 0; ctr < order.Length; ctr++)
                                                             order[ctr] = rnd.NextDouble();
                                                      }
                                                      Array.Sort(order, chars);
                                                      Console.WriteLine("{0} --> {1}", word,
                                                                        new String(chars));
                                                    }, word6));

      Task.WaitAll(tasks.ToArray());
   }
}
// The example displays output like the following:
//    regain --> irnaeg
//    ordain --> rioadn
//    reason --> soearn
//    rained --> rinade
//    rioter --> itrore
//    senior --> norise
//    rental --> atnerl
//    editor --> oteird
Imports System.Collections.Generic
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim tasks As New List(Of Task)()
      Dim rnd As New Random()
      Dim lockObj As New Object()
      Dim words6() As String = { "reason", "editor", "rioter", "rental",
                                 "senior", "regain", "ordain", "rained" }

      For Each word6 in words6
         tasks.Add(Task.Factory.StartNew( Sub(word)
                                              Dim chars() As Char = word.ToString().ToCharArray()
                                              Dim order(chars.Length - 1) As Double
                                              SyncLock lockObj
                                                 For ctr As Integer = 0 To order.Length - 1
                                                    order(ctr) = rnd.NextDouble()
                                                 Next
                                              End SyncLock
                                              Array.Sort(order, chars)
                                              Console.WriteLine("{0} --> {1}", word,
                                                                new String(chars))
                                          End Sub, word6))
      Next
      Task.WaitAll(tasks.ToArray())
   End Sub
End Module
' The example displays output like the following:
'       regain --> irnaeg
'       ordain --> rioadn
'       reason --> soearn
'       rained --> rinade
'       rioter --> itrore
'       senior --> norise
'       rental --> atnerl
'       editor --> oteird

이 예제에서는 잠금으로 보호 되는 단일 난수 생성기를 초기화 합니다.Note that the example initializes a single random number generator, which is protected by a lock. 잠금을 필요로 하려면 클래스 항목의 "System.web 클래스 및 스레드 보안"을 참조 하십시오 Random .For the need of a lock, see "The System.Random class and thread safety" in the Random class topic.

설명

호출은 StartNew Task 해당 생성자 중 하나를 사용 하 여를 만든 다음 메서드를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task using one of its constructors and then calling the Start method to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍의 System.threading.tasks.taskfactory.startnew 실행 및 작업 을 참조 하세요.For more information and code examples, see Task.Run vs Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

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

지정된 함수 대리자, 취소 토큰, 생성 옵션 및 작업 스케줄러에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, cancellation token, creation options and task scheduler.

public:
generic <typename TResult>
 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<TResult> (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(Of TResult) (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls the behavior of the created task.

scheduler
TaskScheduler

만들어진 작업을 예약하는 데 사용할 작업 스케줄러입니다.The task scheduler that is used to schedule the created task.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

function이(가) null인 경우function is null.

또는-or- scheduler이(가) null인 경우scheduler is null.

creationOptions가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions specifies an invalid TaskCreationOptions value. 자세한 내용은 FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)에 대한 설명을 참조하십시오.For more information, see the Remarks for FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

설명

System.threading.tasks.taskfactory.startnew 호출은 Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

StartNew<TResult>(Func<TResult>)

지정된 함수 대리자에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function);
member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>
Public Function StartNew(Of TResult) (function As Func(Of TResult)) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

function 인수가 null인 경우The function argument is null.

예제

다음 예제는 두 개의 난수를 생성 하 고 사용자에 게 합계를 입력 하 라는 메시지를 표시 하는 간단한 추가 앱입니다.The following example is a simple addition app that generates two random numbers and prompts the user to enter their sum. 그런 다음 답변이 올바른지, 아니면 사용자의 응답이 유효한 숫자가 아닌 경우 사용자에 게 유효한 숫자를 다시 입력 하 라는 메시지를 표시 합니다.It then indicates whether the answer is correct or, if the user's response is not a valid number, prompts the user to re-enter a valid number. StartNew Task<TResult> 추가할 난수를 반환 하는 개체를 만드는 데 사용 됩니다.The StartNew is used to create the Task<TResult> objects that return the random numbers to add.

using System;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      Random rnd = new Random();
      Task<int>[] tasks = new Task<int>[2];
      Object obj = new Object();
      
      while (true) {
         for (int ctr = 0; ctr <= 1; ctr++)
            tasks[ctr] = Task.Factory.StartNew(() => { int i = 0;
                                                       lock(obj) {
                                                          i = rnd.Next(101);
                                                       }
                                                       return i; });

         Task.WaitAll(tasks);
         int n1 = tasks[0].Result;
         int n2 = tasks[1].Result;
         int result = n1 + n2;
         bool validInput = false;
         while (! validInput) {
            ShowMessage(n1, n2);
            string userInput = Console.ReadLine();
            // Process user input.
            if (userInput.Trim().ToUpper() == "X") return;
            int answer;
            validInput = Int32.TryParse(userInput, out answer);
            if (! validInput)
               Console.WriteLine("Invalid input. Try again, but enter only numbers. ");
            else if (answer == result)
               Console.WriteLine("Correct!");
            else
               Console.WriteLine("Incorrect. The correct answer is {0}.", result);
         }
      }
   }

   private static void ShowMessage(int n1, int n2)
   {
      Console.WriteLine("\nEnter 'x' to exit...");
      Console.Write("{0} + {1} = ", n1, n2);
   }
}
// The example displays the following output:
//       Enter 'x' to exit...
//       15 + 11 = 26
//       Correct!
//
//       Enter 'x' to exit...
//       75 + 33 = adc
//       Invalid input. Try again, but enter only numbers.
//
//       Enter 'x' to exit...
//       75 + 33 = 108
//       Correct!
//
//       Enter 'x' to exit...
//       67 + 55 = 133
//       Incorrect. The correct answer is 122.
//
//       Enter 'x' to exit...
//       92 + 51 = 133
//       Incorrect. The correct answer is 143.
//
//       Enter 'x' to exit...
//       81 + 65 = x
   
Imports System.Threading.Tasks

Module AdditionTester
   Public Sub Main()
      Dim rnd As New Random()
      Dim tasks(1) As Task(Of Integer)
      Dim obj As New Object()
      
      Do While True
         For ctr As Integer = 0 To 1
            tasks(ctr) = Task.Factory.StartNew(Function()
                                                  Dim i As Integer
                                                  SyncLock(obj)
                                                     i = rnd.Next(101)
                                                  End SyncLock
                                                  Return i
                                               End Function)
         Next
         Task.WaitAll(tasks)
         Dim n1 As Integer = tasks(0).Result
         Dim n2 As Integer = tasks(1).Result
         Dim result As Integer = n1 + n2
         Dim validInput As Boolean = False
         Do While Not validInput
            ShowMessage(n1, n2)
            Dim userInput As String = Console.ReadLine()
            ' Process user input.
            If userInput.Trim().ToUpper = "X" Then Exit Sub
            Dim answer As Integer
            validInput = Int32.TryParse(userInput, answer)
            If Not validInput Then
               Console.WriteLine("Invalid input. Try again, but enter only numbers. ")
            Else If answer = result Then
               Console.WriteLine("Correct!")
            Else
               Console.WriteLine("Incorrect. The correct answer is {0}.", result)
            End If
         Loop
      Loop
   End Sub
   
   Private Sub ShowMessage(n1 As Integer, n2 As Integer)
      Console.WriteLine()
      Console.WriteLine("Enter 'x' to exit...")
      Console.Write("{0} + {1} = ", n1, n2)
   End Sub
End Module
' The example displays output like the following:
'       Enter 'x' to exit...
'       15 + 11 = 26
'       Correct!
'
'       Enter 'x' to exit...
'       75 + 33 = adc
'       Invalid input. Try again, but enter only numbers.
'
'       Enter 'x' to exit...
'       75 + 33 = 108
'       Correct!
'
'       Enter 'x' to exit...
'       67 + 55 = 133
'       Incorrect. The correct answer is 122.
'
'       Enter 'x' to exit...
'       92 + 51 = 133
'       Incorrect. The correct answer is 143.
'
'       Enter 'x' to exit...
'       81 + 65 = x

설명

호출은 StartNew Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

4.5 .NET Framework부터 Task.Run<TResult>(Func<TResult>) 기본 매개 변수를 사용 하 여 호출 하는 빠른 방법으로 메서드를 호출할 수 있습니다 StartNew .Starting with the .NET Framework 4.5, you can call the Task.Run<TResult>(Func<TResult>) method as a quick way to call StartNew with default parameters. 그러나에 대 한 두 가지 방법의 동작에는 차이가 있습니다. Task.Run<TResult>(Func<TResult>) 기본적으로는 옵션으로 시작 된 자식 작업을 TaskCreationOptions.AttachedToParent 현재 인스턴스에 연결 하는 것을 허용 하지 않습니다 Task<TResult> StartNew<TResult>(Func<TResult>) .Note, however, that there is a difference in behavior between the two methods regarding : Task.Run<TResult>(Func<TResult>) by default does not allow child tasks started with the TaskCreationOptions.AttachedToParent option to attach to the current Task<TResult> instance, whereas StartNew<TResult>(Func<TResult>) does. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

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

지정된 함수 대리자 및 상태에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate and state.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state);
member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>
Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

state
Object

function 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the function delegate.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

function이(가) null인 경우function is null.

설명

System.threading.tasks.taskfactory.startnew 호출은 Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

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

지정된 함수 대리자 및 취소 토큰에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate and cancellation token.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function, System.Threading.CancellationToken cancellationToken);
member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>
Public Function StartNew(Of TResult) (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

function이(가) null인 경우function is null.

예제

다음 예에서는 두 개의 작업을 사용 하 여 F100 = F100 + F100-2 (초기값 값 F1 = 1, F2 = 1 및 F1 = 0, F2 = 1)로 끝나는 피보나치 시퀀스를 계산 합니다.The following example uses two tasks to compute the Fibonacci sequence ending in F100 = F100-1 + F100-2 with seed values F1= 1, F2 = 1 and F1 = 0, F2= 1. 대략적으로 취소 토큰은 작업이 실행 될 때 설정 됩니다.Approximately half of the time, a cancellation token is set as the operations execute. 예제의 출력에서는 두 작업이 성공적으로 완료 되 고 토큰이 취소 된 경우의 결과를 보여 줍니다.The output from the example shows the result if the two tasks complete successfully and if the token is cancelled.

using System;
using System.Collections.Generic;
using System.Numerics;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var rnd = new Random();
      var tasks = new List<Task<BigInteger[]>>();
      var source = new CancellationTokenSource();
      var token = source.Token;
      for (int ctr = 0; ctr <= 1; ctr++) {
         int start = ctr;
         tasks.Add(Task.Run( () => { BigInteger[] sequence = new BigInteger[100];
                                     sequence[0] = start;
                                     sequence[1] = 1;
                                     for (int index = 2; index <= sequence.GetUpperBound(0); index++) {
                                        token.ThrowIfCancellationRequested();
                                        sequence[index] = sequence[index - 1] + sequence[index - 2];
                                     }
                                     return sequence;
                                   }, token));
      }
      if (rnd.Next(0, 2) == 1)
         source.Cancel();
      try {
         Task.WaitAll(tasks.ToArray());
         foreach (var t in tasks)
            Console.WriteLine("{0}, {1}...{2:N0}", t.Result[0], t.Result[1],
                              t.Result[99]);
      }
      catch (AggregateException e) {
         foreach (var ex in e.InnerExceptions)
            Console.WriteLine("{0}: {1}", ex.GetType().Name, ex.Message);
      }
   }
}
// The example displays either the following output:
//    0, 1...218,922,995,834,555,169,026
//    1, 1...354,224,848,179,261,915,075
// or the following output:
//    TaskCanceledException: A task was canceled.
//    TaskCanceledException: A task was canceled.
Imports System.Collections.Generic
Imports System.Numerics
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim tasks As New List(Of Task(Of BigInteger()))
      Dim source As New CancellationTokenSource
      Dim token As CancellationToken = source.Token
      For ctr As Integer = 0 To 1
         Dim start As Integer = ctr
         tasks.Add(Task.Run(Function()
                               Dim sequence(99) As BigInteger
                               sequence(0) = start
                               sequence(1) = 1
                               For index As Integer = 2 To sequence.GetUpperBound(0)
                                  token.ThrowIfCancellationRequested()
                                  sequence(index) = sequence(index - 1) + sequence(index - 2)
                               Next
                               Return sequence
                            End Function, token))
      Next
      If rnd.Next(0, 2) = 1 Then source.Cancel
      Try
         Task.WaitAll(tasks.ToArray())
         For Each t In tasks
            Console.WriteLine("{0}, {1}...{2:N0}", t.Result(0), t.Result(1),
                              t.Result(99))
         Next
      Catch e As AggregateException
         For Each ex In e.InnerExceptions
            Console.WriteLine("{0}: {1}", ex.GetType().Name, ex.Message)
         Next
      End Try
   End Sub
End Module
' The example displays either the following output:
'    0, 1...218,922,995,834,555,169,026
'    1, 1...354,224,848,179,261,915,075
' or the following output:
'    TaskCanceledException: A task was canceled.
'    TaskCanceledException: A task was canceled.

설명

호출은 StartNew Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 메서드를 사용 하 여 기본 매개 변수를 사용 하는 Task.Run<TResult>(Func<TResult>, CancellationToken) 빠른 방법으로 호출할 수 있습니다 StartNew<TResult>(Func<TResult>, CancellationToken) .Starting with the .NET Framework 4.5, you can use the Task.Run<TResult>(Func<TResult>, CancellationToken) method as a quick way to call StartNew<TResult>(Func<TResult>, CancellationToken) with default parameters. 그러나에 대 한 두 가지 방법의 동작에는 차이가 있습니다. Task.Run<TResult>(Func<TResult>, CancellationToken) 기본적으로는 옵션으로 시작 된 자식 작업을 TaskCreationOptions.AttachedToParent 현재 인스턴스에 연결 하는 것을 허용 하지 않습니다 Task<TResult> StartNew<TResult>(Func<TResult>, CancellationToken) .Note, however, that there is a difference in behavior between the two methods regarding : Task.Run<TResult>(Func<TResult>, CancellationToken) by default does not allow child tasks started with the TaskCreationOptions.AttachedToParent option to attach to the current Task<TResult> instance, whereas StartNew<TResult>(Func<TResult>, CancellationToken) does. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

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

지정된 함수 대리자 및 생성 옵션에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate and creation options.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (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(Of TResult) (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls the behavior of the created task.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

function이(가) null인 경우function is null.

creationOptions가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions specifies an invalid TaskCreationOptions value. 자세한 내용은 FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)에 대한 설명을 참조하십시오.For more information, see the Remarks for FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

설명

System.threading.tasks.taskfactory.startnew 호출은 Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

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

지정된 함수 대리자, 상태 및 취소 토큰에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, state and cancellation token.

public:
generic <typename TResult>
 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<TResult> (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (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(Of TResult) (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

state
Object

function 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the function delegate.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

function이(가) null인 경우function is null.

설명

System.threading.tasks.taskfactory.startnew 호출은 Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

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

지정된 함수 대리자, 상태 및 생성 옵션에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, state and creation options.

public:
generic <typename TResult>
 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<TResult> (Func<object,TResult> function, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (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(Of TResult) (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

state
Object

function 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the function delegate.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls the behavior of the created task.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

function이(가) null인 경우function is null.

creationOptions가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions specifies an invalid TaskCreationOptions value. 자세한 내용은 FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)에 대한 설명을 참조하십시오.For more information, see the Remarks for FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

설명

System.threading.tasks.taskfactory.startnew 호출은 Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

적용 대상

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

지정된 함수 대리자, 상태, 취소 토큰, 생성 옵션 및 작업 스케줄러에 대한 TResult 형식의 작업을 만들고 시작합니다.Creates and starts a task of type TResult for the specified function delegate, state, cancellation token, creation options and task scheduler.

public:
generic <typename TResult>
 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<TResult> (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);
public System.Threading.Tasks.Task<TResult> StartNew<TResult> (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(Of TResult) (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

형식 매개 변수

TResult

작업을 통해 사용할 수 있는 결과의 형식입니다.The type of the result available through the task.

매개 변수

function
Func<Object,TResult>

작업을 통해 사용할 수 있는 이후 결과를 반환하는 함수 대리자입니다.A function delegate that returns the future result to be available through the task.

state
Object

function 대리자가 사용할 데이터가 포함된 개체입니다.An object containing data to be used by the function delegate.

cancellationToken
CancellationToken

새 작업에 할당할 취소 토큰입니다.The cancellation token that will be assigned to the new task.

creationOptions
TaskCreationOptions

만들어진 작업의 동작을 제어하는 열거형 값 중 하나입니다.One of the enumeration values that controls the behavior of the created task.

scheduler
TaskScheduler

만들어진 작업을 예약하는 데 사용할 작업 스케줄러입니다.The task scheduler that is used to schedule the created task.

반환

Task<TResult>

시작된 작업입니다.The started task.

예외

제공된 CancellationToken가 이미 삭제된 경우The provided CancellationToken has already been disposed.

function이(가) null인 경우function is null.

또는-or- scheduler이(가) null인 경우scheduler is null.

creationOptions가 잘못된 TaskCreationOptions 값을 지정합니다.creationOptions specifies an invalid TaskCreationOptions value. 자세한 내용은 FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)에 대한 설명을 참조하십시오.For more information, see the Remarks for FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions)

설명

System.threading.tasks.taskfactory.startnew 호출은 Task<TResult> 해당 생성자 중 하나를 사용 하 여를 만든 다음를 호출 하 여 실행을 예약 하는 것과 기능적으로 동일 Start 합니다.Calling StartNew is functionally equivalent to creating a Task<TResult> using one of its constructors and then calling Start to schedule it for execution.

.NET Framework 4.5부터 Run 메서드를 개체와 함께 사용 Action 하 여 StartNew 기본 매개 변수를 사용 하는 빠른 방법으로를 호출할 수 있습니다.Starting with the .NET Framework 4.5, you can use the Run method with an Action object as a quick way to call StartNew with default parameters. 자세한 내용 및 코드 예제는 .NET 블로그를 사용 하 여 병렬 프로그래밍에서 system.threading.tasks.taskfactory.startnew 및 작업 항목을 참조 하세요.For more information and code examples, see the entry Task.Run vs. Task.Factory.StartNew in the Parallel Programming with .NET blog.

추가 정보

적용 대상