ParallelLoopState.IsStopped ParallelLoopState.IsStopped ParallelLoopState.IsStopped ParallelLoopState.IsStopped Property

Definition

Ruft einen Wert ab, der angibt, ob eine Iteration der Schleife die Stop()-Methode aufgerufen hat.Gets whether any iteration of the loop has called the Stop() method.

public:
 property bool IsStopped { bool get(); };
public bool IsStopped { get; }
member this.IsStopped : bool
Public ReadOnly Property IsStopped As Boolean

Eigenschaftswert

true, wenn die Schleife beendet wurde, indem in einer Iteration die Stop()-Methode aufgerufen wurde, andernfalls false.true if any iteration has stopped the loop by calling the Stop() method; otherwise, false.

Beispiele

Im folgenden Beispiel werden bis zu 10.000 Iterationen einer Schleife parallel ausgeführt.The following example executes up to 10,000 iterations of a loop in parallel. Jede Iterations Pause wird für ein zufälliges Intervall von 1 bis 1.000 Millisekunden angehalten.Each iteration pauses for a random interval from 1 to 1,000 milliseconds. Ein zufällig generierter Wert bestimmt, in welcher Iterations Schleife die Stop Methode aufgerufen wird.A randomly generated value determines on which iteration of the loop the Stop method is called. Da Iterationen der Schleife wahrscheinlich beim Aufrufen der Stop -Methode ausgeführt werden, ruft der Lambda-Ausdruck die IsStopped -Methode auf, um zu überprüfen, ob die Stop -Methode von einer anderen Iteration aufgerufen wurde.Because iterations of the loop are still likely to be executing when the Stop method is called, the lambda expression calls the IsStopped method to check whether another iteration has called the Stop method. Wenn zurück truegegeben wird, wird die Iterationen sofort zurückgegeben.If it returns true, the iteration returns immediately.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var rnd = new Random();
      long stopIndex = rnd.Next(1, 11);

      Console.WriteLine("Will call Stop in iteration {0}\n", stopIndex);

      var result = Parallel.For(1, 10000, (i, state) => {
                                            Console.WriteLine("Beginning iteration {0}", i);
                                            int delay;
                                            Monitor.Enter(rnd);
                                               delay = rnd.Next(1, 1001);
                                            Monitor.Exit(rnd);
                                            Thread.Sleep(delay);
                                            
                                            if (i == stopIndex) {
                                               Console.WriteLine("Stop in iteration {0}", i);
                                               state.Stop();
                                               return;
                                            }

                                            if (state.IsStopped) {
                                               return;
                                            }

                                            Console.WriteLine("Completed iteration {0}", i);
                                       });
   }
}
// The example displays output like the following:
//       Will call Stop in iteration 5
//
//       Beginning iteration 1
//       Beginning iteration 9993
//       Beginning iteration 8744
//       Beginning iteration 6246
//       Beginning iteration 7495
//       Beginning iteration 3748
//       Beginning iteration 4997
//       Beginning iteration 2499
//       Beginning iteration 1250
//       Completed iteration 6246
//       Beginning iteration 6247
//       Completed iteration 3748
//       Beginning iteration 3749
//       Completed iteration 8744
//       Beginning iteration 8745
//       Completed iteration 7495
//       Beginning iteration 7496
//       Completed iteration 1250
//       Beginning iteration 1251
//       Completed iteration 2499
//       Beginning iteration 2500
//       Completed iteration 1
//       Beginning iteration 2
//       Completed iteration 2500
//       Beginning iteration 2501
//       Completed iteration 3749
//       Beginning iteration 3750
//       Completed iteration 6247
//       Beginning iteration 6248
//       Completed iteration 7496
//       Beginning iteration 7497
//       Completed iteration 3750
//       Beginning iteration 3751
//       Completed iteration 2
//       Beginning iteration 3
//       Completed iteration 9993
//       Beginning iteration 9994
//       Completed iteration 8745
//       Beginning iteration 8746
//       Completed iteration 4997
//       Completed iteration 9994
//       Beginning iteration 9995
//       Beginning iteration 4998
//       Completed iteration 6248
//       Beginning iteration 6249
//       Completed iteration 7497
//       Beginning iteration 7498
//       Completed iteration 1251
//       Beginning iteration 1252
//       Completed iteration 2501
//       Beginning iteration 2502
//       Completed iteration 9995
//       Beginning iteration 9996
//       Completed iteration 4998
//       Beginning iteration 4999
//       Completed iteration 2502
//       Beginning iteration 2503
//       Completed iteration 1252
//       Beginning iteration 1253
//       Completed iteration 7498
//       Beginning iteration 7499
//       Completed iteration 3751
//       Beginning iteration 3752
//       Completed iteration 9996
//       Beginning iteration 9997
//       Completed iteration 1253
//       Beginning iteration 1254
//       Completed iteration 9997
//       Beginning iteration 9998
//       Completed iteration 1254
//       Beginning iteration 1255
//       Completed iteration 6249
//       Beginning iteration 6250
//       Completed iteration 3
//       Beginning iteration 4
//       Completed iteration 4
//       Beginning iteration 5
//       Completed iteration 4999
//       Beginning iteration 5000
//       Completed iteration 8746
//       Beginning iteration 8747
//       Stop in iteration 5
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim stopIndex As Long = rnd.Next(1, 11)

      Console.WriteLine("Will call Stop in iteration {0}", stopIndex)
      Console.WriteLine()

      Dim result = Parallel.For(1, 10000, Sub(i, state)
                                            Console.WriteLine("Beginning iteration {0}", i)
                                            Dim delay As Integer
                                            Monitor.Enter(rnd)
                                               delay = rnd.Next(1, 1001)
                                            Monitor.Exit(rnd)
                                            Thread.Sleep(delay)

                                            If i = stopIndex Then
                                               Console.WriteLine("Stop in iteration {0}", i)
                                               state.Stop()
                                               Return
                                            End If

                                            If state.IsStopped Then
                                               Return
                                            End If

                                            Console.WriteLine("Completed iteration {0}", i)
                                       End Sub)
    End Sub
End Module
' The example displays output like the following:
'       Will call Stop in iteration 5
'
'       Beginning iteration 1
'       Beginning iteration 9993
'       Beginning iteration 8744
'       Beginning iteration 6246
'       Beginning iteration 7495
'       Beginning iteration 3748
'       Beginning iteration 4997
'       Beginning iteration 2499
'       Beginning iteration 1250
'       Completed iteration 6246
'       Beginning iteration 6247
'       Completed iteration 3748
'       Beginning iteration 3749
'       Completed iteration 8744
'       Beginning iteration 8745
'       Completed iteration 7495
'       Beginning iteration 7496
'       Completed iteration 1250
'       Beginning iteration 1251
'       Completed iteration 2499
'       Beginning iteration 2500
'       Completed iteration 1
'       Beginning iteration 2
'       Completed iteration 2500
'       Beginning iteration 2501
'       Completed iteration 3749
'       Beginning iteration 3750
'       Completed iteration 6247
'       Beginning iteration 6248
'       Completed iteration 7496
'       Beginning iteration 7497
'       Completed iteration 3750
'       Beginning iteration 3751
'       Completed iteration 2
'       Beginning iteration 3
'       Completed iteration 9993
'       Beginning iteration 9994
'       Completed iteration 8745
'       Beginning iteration 8746
'       Completed iteration 4997
'       Completed iteration 9994
'       Beginning iteration 9995
'       Beginning iteration 4998
'       Completed iteration 6248
'       Beginning iteration 6249
'       Completed iteration 7497
'       Beginning iteration 7498
'       Completed iteration 1251
'       Beginning iteration 1252
'       Completed iteration 2501
'       Beginning iteration 2502
'       Completed iteration 9995
'       Beginning iteration 9996
'       Completed iteration 4998
'       Beginning iteration 4999
'       Completed iteration 2502
'       Beginning iteration 2503
'       Completed iteration 1252
'       Beginning iteration 1253
'       Completed iteration 7498
'       Beginning iteration 7499
'       Completed iteration 3751
'       Beginning iteration 3752
'       Completed iteration 9996
'       Beginning iteration 9997
'       Completed iteration 1253
'       Beginning iteration 1254
'       Completed iteration 9997
'       Beginning iteration 9998
'       Completed iteration 1254
'       Beginning iteration 1255
'       Completed iteration 6249
'       Beginning iteration 6250
'       Completed iteration 3
'       Beginning iteration 4
'       Completed iteration 4
'       Beginning iteration 5
'       Completed iteration 4999
'       Beginning iteration 5000
'       Completed iteration 8746
'       Beginning iteration 8747
'       Stop in iteration 5

Hinweise

Für Iterationen mit langer Ausführungszeit können Sie den Wert der IsStopped -Eigenschaft abrufen, um zu bestimmen, ob Iterationen der Schleife, die vor dem Aufrufen Stop der-Methode gestartet wurden, noch ausgeführt werden.For long-running iterations of the loop, you can retrieve the value of the IsStopped property to determine whether any iterations of the loop that began execution before the call to the Stop method are still executing. Anschließend können Sie den Wert IsStopped der-Eigenschaft verwenden, um zu bestimmen, ob Sie sofort zurückkehren oder ordnungsgemäß ausgeführt werden sollen.You can then use the value of the IsStopped property to determine whether they should return immediately or execute normally.

Gilt für:

Siehe auch