Thread.Join Methode

Definition

Namespace:: System.Threading

Assemblys:: netstandard.dll, System.Threading.Thread.dll

Assembly:: System.Threading.Thread.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Blockiert den aufrufenden Thread, bis der von dieser Instanz dargestellte Thread beendet wird.

Überlädt

Name	Beschreibung
Join()	Blockiert den aufrufenden Thread, bis der durch diese Instanz dargestellte Thread beendet wird, während weiterhin standardmäßiges COM und `SendMessage` Pumping ausgeführt wird.
Join(Int32)	Blockiert den aufrufenden Thread, bis der von dieser Instanz dargestellte Thread beendet wird oder die angegebene Zeit verstrichen ist, während weiterhin standardmäßiges COM- und SendMessage-Pumping ausgeführt wird.
Join(TimeSpan)	Blockiert den aufrufenden Thread, bis der von dieser Instanz dargestellte Thread beendet wird oder die angegebene Zeit verstrichen ist, während weiterhin standardmäßiges COM- und SendMessage-Pumping ausgeführt wird.

Join()

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Blockiert den aufrufenden Thread, bis der durch diese Instanz dargestellte Thread beendet wird, während weiterhin standardmäßiges COM und SendMessage Pumping ausgeführt wird.

public:
 void Join();

public void Join();

member this.Join : unit -> unit

Public Sub Join ()

Ausnahmen

ThreadStateException

Der Aufrufer hat versucht, einen Thread zu verbinden, der sich Unstarted im Zustand befindet.

ThreadInterruptedException

Der Thread wird beim Warten unterbrochen.

Hinweise

Join ist eine Synchronisierungsmethode, die den aufrufenden Thread (d. h. den Thread, der die Methode aufruft) blockiert, bis der Thread, dessen Join Methode aufgerufen wird, abgeschlossen ist. Verwenden Sie diese Methode, um sicherzustellen, dass ein Thread beendet wurde. Der Aufrufer wird unbegrenzt blockiert, wenn der Thread nicht beendet wird. Im folgenden Beispiel ruft der Thread1 Thread die Join() Methode von Thread2, die blockiert Thread1 wird, bis Thread2 der Vorgang abgeschlossen ist.

using System;
using System.Threading;

public class Example
{
   static Thread thread1, thread2;
   
   public static void Main()
   {
      thread1 = new Thread(ThreadProc);
      thread1.Name = "Thread1";
      thread1.Start();
      
      thread2 = new Thread(ThreadProc);
      thread2.Name = "Thread2";
      thread2.Start();   
   }

   private static void ThreadProc()
   {
      Console.WriteLine("\nCurrent thread: {0}", Thread.CurrentThread.Name);
      if (Thread.CurrentThread.Name == "Thread1" && 
          thread2.ThreadState != ThreadState.Unstarted)
         thread2.Join();
      
      Thread.Sleep(4000);
      Console.WriteLine("\nCurrent thread: {0}", Thread.CurrentThread.Name);
      Console.WriteLine("Thread1: {0}", thread1.ThreadState);
      Console.WriteLine("Thread2: {0}\n", thread2.ThreadState);
   }
}
// The example displays output like the following:
//       Current thread: Thread1
//       
//       Current thread: Thread2
//       
//       Current thread: Thread2
//       Thread1: WaitSleepJoin
//       Thread2: Running
//       
//       
//       Current thread: Thread1
//       Thread1: Running
//       Thread2: Stopped

open System.Threading

let mutable thread1, thread2 =
    Unchecked.defaultof<Thread>, Unchecked.defaultof<Thread>

let threadProc () =
    printfn $"\nCurrent thread: {Thread.CurrentThread.Name}"

    if
        Thread.CurrentThread.Name = "Thread1"
        && thread2.ThreadState <> ThreadState.Unstarted
    then
        thread2.Join()

    Thread.Sleep 4000
    printfn $"\nCurrent thread: {Thread.CurrentThread.Name}"
    printfn $"Thread1: {thread1.ThreadState}"
    printfn $"Thread2: {thread2.ThreadState}\n"

thread1 <- Thread threadProc
thread1.Name <- "Thread1"
thread1.Start()

thread2 <- Thread threadProc
thread2.Name <- "Thread2"
thread2.Start()

// The example displays output like the following:
//       Current thread: Thread1
//
//       Current thread: Thread2
//
//       Current thread: Thread2
//       Thread1: WaitSleepJoin
//       Thread2: Running
//
//
//       Current thread: Thread1
//       Thread1: Running
//       Thread2: Stopped

Imports System.Threading

Module Example
   Dim thread1, thread2 As Thread

   Public Sub Main()
      thread1 = new Thread(AddressOf ThreadProc)
      thread1.Name = "Thread1"
      thread1.Start()
      
      thread2 = New Thread(AddressOf ThreadProc)
      thread2.Name = "Thread2"
      thread2.Start()   
   End Sub

   Private Sub ThreadProc()
      Console.WriteLine()
      Console.WriteLine("Current thread: {0}", Thread.CurrentThread.Name)
      If (Thread.CurrentThread.Name = "Thread1" And 
          thread2.ThreadState <> ThreadState.Unstarted)
         thread2.Join()
      End If
      Thread.Sleep(4000)
      Console.WriteLine()
      Console.WriteLine("Current thread: {0}", Thread.CurrentThread.Name)
      Console.WriteLine("Thread1: {0}", thread1.ThreadState)
      Console.WriteLine("Thread2: {0}", thread2.ThreadState)
      Console.WriteLine()
   End Sub
End Module
' The example displays output like the following :
'       Current thread: Thread1
'       
'       Current thread: Thread2
'       
'       Current thread: Thread2
'       Thread1: WaitSleepJoin
'       Thread2: Running
'       
'       
'       Current thread: Thread1
'       Thread1: Running
'       Thread2: Stopped

Wenn der Thread beim Aufrufen bereits beendet Join wurde, gibt die Methode sofort zurück.

Warning

Sie sollten niemals die Join Methode des Thread Objekts aufrufen, das den aktuellen Thread aus dem aktuellen Thread darstellt. Dies führt dazu, dass Ihre App nicht mehr reagiert, da der aktuelle Thread unbegrenzt auf sich selbst wartet.

Diese Methode ändert den Zustand des aufrufenden Threads so, dass er eingeschlossen wird ThreadState.WaitSleepJoin. Sie können keinen Thread aufrufen Join , der sich im ThreadState.Unstarted Zustand befindet.

Weitere Informationen

ThreadState

Gilt für:

Join(Int32)

Quelle:: Thread.CoreCLR.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Blockiert den aufrufenden Thread, bis der von dieser Instanz dargestellte Thread beendet wird oder die angegebene Zeit verstrichen ist, während weiterhin standardmäßiges COM- und SendMessage-Pumping ausgeführt wird.

public:
 bool Join(int millisecondsTimeout);

public bool Join(int millisecondsTimeout);

member this.Join : int -> bool

Public Function Join (millisecondsTimeout As Integer) As Boolean

Parameter

millisecondsTimeout: Int32

Die Anzahl der Millisekunden, die warten, bis der Thread beendet wird.

Gibt zurück

Boolean

true wenn der Thread beendet wurde; false wenn der Thread nach ablauf der vom Parameter angegebenen millisecondsTimeout Zeit nicht beendet wurde.

Ausnahmen

ArgumentOutOfRangeException

Der Wert von millisecondsTimeout ist negativ und entspricht nicht Infinite in Millisekunden.

ThreadStateException

Der Thread wurde nicht gestartet.

ArgumentException

millisecondsTimeout ist kleiner als -1 (Timeout.Infinite).

ThreadInterruptedException

Der Thread wurde beim Warten unterbrochen.

Hinweise

Join(Int32) ist eine Synchronisierungsmethode, die den aufrufenden Thread (d. h. den Thread, der die Methode aufruft) blockiert, bis entweder der Thread, dessen Join Methode aufgerufen wird, abgeschlossen ist oder das Timeoutintervall abgelaufen ist. Im folgenden Beispiel ruft der Thread1 Thread die Join() Methode von Thread2, die dazu führt Thread1 , dass entweder blockiert wird, bis Thread2 abgeschlossen oder 2 Sekunden verstrichen sind.

using System;
using System.Threading;

public class Example
{
   static Thread thread1, thread2;
   
   public static void Main()
   {
      thread1 = new Thread(ThreadProc);
      thread1.Name = "Thread1";
      thread1.Start();
      
      thread2 = new Thread(ThreadProc);
      thread2.Name = "Thread2";
      thread2.Start();   
   }

   private static void ThreadProc()
   {
      Console.WriteLine("\nCurrent thread: {0}", Thread.CurrentThread.Name);
      if (Thread.CurrentThread.Name == "Thread1" && 
          thread2.ThreadState != ThreadState.Unstarted)
         if (thread2.Join(2000))
            Console.WriteLine("Thread2 has termminated.");
         else
            Console.WriteLine("The timeout has elapsed and Thread1 will resume.");   
      
      Thread.Sleep(4000);
      Console.WriteLine("\nCurrent thread: {0}", Thread.CurrentThread.Name);
      Console.WriteLine("Thread1: {0}", thread1.ThreadState);
      Console.WriteLine("Thread2: {0}\n", thread2.ThreadState);
   }
}
// The example displays the following output:
//       Current thread: Thread1
//       
//       Current thread: Thread2
//       The timeout has elapsed and Thread1 will resume.
//       
//       Current thread: Thread2
//       Thread1: WaitSleepJoin
//       Thread2: Running
//       
//       
//       Current thread: Thread1
//       Thread1: Running
//       Thread2: Stopped

open System.Threading

let mutable thread1, thread2 =
    Unchecked.defaultof<Thread>, Unchecked.defaultof<Thread>

let threadProc () =
    printfn $"\nCurrent thread: {Thread.CurrentThread.Name}"

    if
        Thread.CurrentThread.Name = "Thread1"
        && thread2.ThreadState <> ThreadState.Unstarted
    then
        if thread2.Join 2000 then
            printfn "Thread2 has termminated."
        else
            printfn "The timeout has elapsed and Thread1 will resume."

    Thread.Sleep 4000
    printfn $"\nCurrent thread: {Thread.CurrentThread.Name}"
    printfn $"Thread1: {thread1.ThreadState}"
    printfn $"Thread2: {thread2.ThreadState}\n"

thread1 <- Thread threadProc
thread1.Name <- "Thread1"
thread1.Start()

thread2 <- Thread threadProc
thread2.Name <- "Thread2"
thread2.Start()

// The example displays the following output:
//       Current thread: Thread1
//
//       Current thread: Thread2
//       The timeout has elapsed and Thread1 will resume.
//
//       Current thread: Thread2
//       Thread1: WaitSleepJoin
//       Thread2: Running
//
//
//       Current thread: Thread1
//       Thread1: Running
//       Thread2: Stopped

Imports System.Threading

Module Example
   Dim thread1, thread2 As Thread

   Public Sub Main()
      thread1 = new Thread(AddressOf ThreadProc)
      thread1.Name = "Thread1"
      thread1.Start()
      
      thread2 = New Thread(AddressOf ThreadProc)
      thread2.Name = "Thread2"
      thread2.Start()   
   End Sub

   Private Sub ThreadProc()
      Console.WriteLine()
      Console.WriteLine("Current thread: {0}", Thread.CurrentThread.Name)
      If (Thread.CurrentThread.Name = "Thread1" And 
          thread2.ThreadState <> ThreadState.Unstarted)
         If thread2.Join(TimeSpan.FromSeconds(2))
            Console.WriteLine("Thread2 has termminated.")
         Else
            Console.WriteLine("The timeout has elapsed and Thread1 will resume.")
         End If      
      End If
      Thread.Sleep(4000)
      Console.WriteLine()
      Console.WriteLine("Current thread: {0}", Thread.CurrentThread.Name)
      Console.WriteLine("Thread1: {0}", thread1.ThreadState)
      Console.WriteLine("Thread2: {0}", thread2.ThreadState)
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'       Current thread: Thread1
'       
'       Current thread: Thread2
'       
'       Current thread: Thread2
'       Thread1: WaitSleepJoin
'       Thread2: Running
'       
'       
'       Current thread: Thread1
'       Thread1: Running
'       Thread2: Stopped

Wenn Timeout.Infinite für den millisecondsTimeout Parameter angegeben wird, verhält sich diese Methode identisch mit der Join() Methodenüberladung, mit Ausnahme des Rückgabewerts.

Wenn der Thread beim Aufrufen bereits beendet Join wurde, gibt die Methode sofort zurück.

Weitere Informationen

ThreadState

Gilt für:

Join(TimeSpan)

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

Quelle:: Thread.cs

public:
 bool Join(TimeSpan timeout);

public bool Join(TimeSpan timeout);

member this.Join : TimeSpan -> bool

Public Function Join (timeout As TimeSpan) As Boolean

Parameter

timeout: TimeSpan

Ein TimeSpan Wert, der auf den Zeitraum festgelegt ist, der auf das Beenden des Threads wartet.

Gibt zurück

Boolean

true wenn der Thread beendet wurde; false wenn der Thread nach ablauf der vom Parameter angegebenen timeout Zeit nicht beendet wurde.

Ausnahmen

ArgumentOutOfRangeException

Der Wert ist timeout negativ und ist nicht gleich Infinite in Millisekunden oder größer als Int32.MaxValue Millisekunden.

ThreadStateException

Der Aufrufer hat versucht, einen Thread zu verbinden, der sich Unstarted im Zustand befindet.

Beispiele

Im folgenden Codebeispiel wird die Verwendung eines TimeSpan Werts mit der Join Methode veranschaulicht.

using System;
using System.Threading;

class Test
{
    static TimeSpan waitTime = new TimeSpan(0, 0, 1);

    public static void Main() 
    {
        Thread newThread = new Thread(Work);
        newThread.Start();

        if(newThread.Join(waitTime + waitTime)) {
            Console.WriteLine("New thread terminated.");
        }
        else {
            Console.WriteLine("Join timed out.");
        }
    }

    static void Work()
    {
        Thread.Sleep(waitTime);
    }
}
// The example displays the following output:
//        New thread terminated.

open System
open System.Threading

let waitTime = TimeSpan(0, 0, 1)

let work () =
    Thread.Sleep waitTime

let newThread = Thread work
newThread.Start()

if waitTime + waitTime |> newThread.Join then
    printfn "New thread terminated."
else
    printfn "Join timed out."

// The example displays the following output:
//        New thread terminated.

Imports System.Threading

Public Module Test
    Dim waitTime As New TimeSpan(0, 0, 1)

    Public Sub Main() 
        Dim newThread As New Thread(AddressOf Work)
        newThread.Start()

        If newThread.Join(waitTime + waitTime) Then
            Console.WriteLine("New thread terminated.")
        Else
            Console.WriteLine("Join timed out.")
        End If
    End Sub

    Private Sub Work()
        Thread.Sleep(waitTime)
    End Sub
End Module
' The example displays the following output:
'       New thread terminated.

Hinweise

Join(TimeSpan) ist eine Synchronisierungsmethode, die den aufrufenden Thread (d. h. den Thread, der die Methode aufruft) blockiert, bis entweder der Thread, dessen Join Methode aufgerufen wird, abgeschlossen ist oder das Timeoutintervall abgelaufen ist. Im folgenden Beispiel ruft der Thread1 Thread die Join() Methode von Thread2, die dazu führt Thread1 , dass entweder blockiert wird, bis Thread2 abgeschlossen oder 2 Sekunden verstrichen sind.

using System;
using System.Threading;

public class Example
{
   static Thread thread1, thread2;
   
   public static void Main()
   {
      thread1 = new Thread(ThreadProc);
      thread1.Name = "Thread1";
      thread1.Start();
      
      thread2 = new Thread(ThreadProc);
      thread2.Name = "Thread2";
      thread2.Start();   
   }

   private static void ThreadProc()
   {
      Console.WriteLine("\nCurrent thread: {0}", Thread.CurrentThread.Name);
      if (Thread.CurrentThread.Name == "Thread1" && 
          thread2.ThreadState != ThreadState.Unstarted)
         if (thread2.Join(TimeSpan.FromSeconds(2)))
            Console.WriteLine("Thread2 has termminated.");
         else
            Console.WriteLine("The timeout has elapsed and Thread1 will resume.");   
      
      Thread.Sleep(4000);
      Console.WriteLine("\nCurrent thread: {0}", Thread.CurrentThread.Name);
      Console.WriteLine("Thread1: {0}", thread1.ThreadState);
      Console.WriteLine("Thread2: {0}\n", thread2.ThreadState);
   }
}
// The example displays the following output:
//       Current thread: Thread1
//       
//       Current thread: Thread2
//       The timeout has elapsed and Thread1 will resume.
//       
//       Current thread: Thread2
//       Thread1: WaitSleepJoin
//       Thread2: Running
//       
//       
//       Current thread: Thread1
//       Thread1: Running
//       Thread2: Stopped

open System
open System.Threading

let mutable thread1, thread2 =
    Unchecked.defaultof<Thread>, Unchecked.defaultof<Thread>

let threadProc () =
    printfn $"\nCurrent thread: {Thread.CurrentThread.Name}"

    if
        Thread.CurrentThread.Name = "Thread1"
        && thread2.ThreadState <> ThreadState.Unstarted
    then
        if TimeSpan.FromSeconds 2 |> thread2.Join then
            printfn "Thread2 has termminated."
        else
            printfn "The timeout has elapsed and Thread1 will resume."

    Thread.Sleep 4000
    printfn $"\nCurrent thread: {Thread.CurrentThread.Name}"
    printfn $"Thread1: {thread1.ThreadState}"
    printfn $"Thread2: {thread2.ThreadState}\n"

thread1 <- Thread threadProc
thread1.Name <- "Thread1"
thread1.Start()

thread2 <- Thread threadProc
thread2.Name <- "Thread2"
thread2.Start()

// The example displays the following output:
//       Current thread: Thread1
//
//       Current thread: Thread2
//       The timeout has elapsed and Thread1 will resume.
//
//       Current thread: Thread2
//       Thread1: WaitSleepJoin
//       Thread2: Running
//
//
//       Current thread: Thread1
//       Thread1: Running
//       Thread2: Stopped

Imports System.Threading

Module Example
   Dim thread1, thread2 As Thread

   Public Sub Main()
      thread1 = new Thread(AddressOf ThreadProc)
      thread1.Name = "Thread1"
      thread1.Start()
      
      thread2 = New Thread(AddressOf ThreadProc)
      thread2.Name = "Thread2"
      thread2.Start()   
   End Sub

   Private Sub ThreadProc()
      Console.WriteLine()
      Console.WriteLine("Current thread: {0}", Thread.CurrentThread.Name)
      If (Thread.CurrentThread.Name = "Thread1" And 
          thread2.ThreadState <> ThreadState.Unstarted)
         If thread2.Join(2000)
            Console.WriteLine("Thread2 has termminated.")
         Else
            Console.WriteLine("The timeout has elapsed and Thread1 will resume.")
         End If      
      End If
      Thread.Sleep(4000)
      Console.WriteLine()
      Console.WriteLine("Current thread: {0}", Thread.CurrentThread.Name)
      Console.WriteLine("Thread1: {0}", thread1.ThreadState)
      Console.WriteLine("Thread2: {0}", thread2.ThreadState)
      Console.WriteLine()
   End Sub
End Module
' The example displays the following output:
'       Current thread: Thread1
'       
'       Current thread: Thread2
'       
'       Current thread: Thread2
'       Thread1: WaitSleepJoin
'       Thread2: Running
'       
'       
'       Current thread: Thread1
'       Thread1: Running
'       Thread2: Stopped

Wenn Timeout.Infinite diese timeoutMethode angegeben ist, verhält sich diese Methode identisch mit der Join() Methodenüberladung, mit Ausnahme des Rückgabewerts.

Wenn der Thread beim Aufrufen bereits beendet Join wurde, gibt die Methode sofort zurück.

Mit dieser Methode wird der Status des aktuellen Threads geändert, soweit er eingeschlossen wird WaitSleepJoin. Sie können keinen Thread aufrufen Join , der sich im ThreadState.Unstarted Zustand befindet.

Weitere Informationen

ThreadState

Gilt für:

Feedback

War diese Seite hilfreich?