Thread.Join Metoda

Definice

Obor názvů:

System.Threading

Sestavení:

netstandard.dll, System.Threading.Thread.dll

Blokuje volající vlákno, dokud vlákno reprezentované touto instancí není ukončeno.

Přetížení

Join()	Blokuje volající vlákno, dokud vlákno reprezentované touto instancí neskončí, zatímco pokračuje v provádění standardní com a SendMessage pumpování.
Join(Int32)	Blokuje volající vlákno, dokud vlákno reprezentované touto instancí ukončí nebo uplynou zadanou dobu, zatímco pokračuje v provádění standardní com a SendMessage pumpování.
Join(TimeSpan)	Blokuje volající vlákno, dokud vlákno reprezentované touto instancí ukončí nebo uplynou zadanou dobu, zatímco pokračuje v provádění standardní com a SendMessage pumpování.

Join()

Zdroj:

Thread.cs

Blokuje volající vlákno, dokud vlákno reprezentované touto instancí neskončí, zatímco pokračuje v provádění standardní com a SendMessage pumpování.

public void Join();

Výjimky

ThreadStateException

Volající se pokusil připojit vlákno, které je ve Unstarted stavu .

ThreadInterruptedException

Vlákno se během čekání přeruší.

Poznámky

Join je synchronizační metoda, která blokuje volající vlákno (tj. vlákno, které volá metodu), dokud vlákno, jehož Join metoda je volána je dokončena. Pomocí této metody se ujistěte, že vlákno bylo ukončeno. Volající bude blokovat neomezeně dlouho, pokud vlákno neukončí. V následujícím příkladu Thread1 volá vlákno metodu Join()Thread2, která způsobí Thread1 blokování, dokud Thread2 se nedokončil.

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

Pokud vlákno již ukončeno, když Join je volána, vrátí metoda okamžitě.

Upozornění

Nikdy byste neměli volat metodu Join objektu Thread , který představuje aktuální vlákno z aktuálního vlákna. To způsobí, že vaše aplikace přestane reagovat, protože aktuální vlákno čeká na sebe neomezeně dlouho.

Tato metoda změní stav volajícího vlákna tak, aby zahrnoval ThreadState.WaitSleepJoin. Nelze vyvolat Join ve vlákně, které je ve ThreadState.Unstarted stavu .

Viz také

• ThreadState

Join(Int32)

Zdroj:

Thread.cs

Blokuje volající vlákno, dokud vlákno reprezentované touto instancí ukončí nebo uplynou zadanou dobu, zatímco pokračuje v provádění standardní com a SendMessage pumpování.

public bool Join(int millisecondsTimeout);

Parametry

millisecondsTimeout

Int32

Počet milisekund čekání na ukončení vlákna.

Návraty

Boolean

true pokud vlákno skončilo; false pokud vlákno nebylo ukončeno po uplynutí doby určené parametrem millisecondsTimeout .

Výjimky

ArgumentOutOfRangeException

Hodnota millisecondsTimeout je záporná a nerovná se Infinite v milisekundách.

ThreadStateException

Vlákno nebylo spuštěno.

ArgumentException

millisecondsTimeout je menší než -1 (Timeout.Infinite).

ThreadInterruptedException

Vlákno bylo během čekání přerušeno.

Poznámky

Join(Int32) je synchronizační metoda, která blokuje volající vlákno (tj. vlákno, které volá metodu), dokud se nedokončí vlákno, jehož Join metoda je volána, nebo časový limit. V následujícím příkladu Thread1 volá vlákno metodu Join()Thread2, která způsobí Thread1 , že se zablokuje, dokud Thread2 se nedokončil nebo uplynou 2 sekundy.

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

Pokud Timeout.Infinite je zadán pro millisecondsTimeout parametr, tato metoda se chová stejně jako Join() přetížení metody, s výjimkou návratové hodnoty.

Pokud vlákno již ukončeno, když Join je volána, vrátí metoda okamžitě.

Tato metoda změní stav volajícího vlákna tak, aby zahrnoval ThreadState.WaitSleepJoin. Nelze vyvolat Join ve vlákně, které je ve ThreadState.Unstarted stavu .

Viz také

• ThreadState

Join(TimeSpan)

Zdroj:

Thread.cs

Blokuje volající vlákno, dokud vlákno reprezentované touto instancí ukončí nebo uplynou zadanou dobu, zatímco pokračuje v provádění standardní com a SendMessage pumpování.

public bool Join(TimeSpan timeout);

Parametry

timeout

TimeSpan

Nastaveno TimeSpan na dobu čekání na ukončení vlákna.

Návraty

Boolean

true pokud vlákno skončilo; false pokud vlákno nebylo ukončeno po uplynutí doby určené parametrem timeout .

Výjimky

ArgumentOutOfRangeException

Hodnota timeout je záporná a nerovná se Infinite v milisekundách nebo je větší než Int32.MaxValue milisekund.

ThreadStateException

Volající se pokusil připojit vlákno, které je ve Unstarted stavu .

Příklady

Následující příklad kódu ukazuje, jak použít TimeSpan hodnotu s metodou Join .

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.

Poznámky

Join(TimeSpan) je synchronizační metoda, která blokuje volající vlákno (tj. vlákno, které volá metodu), dokud se nedokončí vlákno, jehož Join metoda je volána, nebo časový limit. V následujícím příkladu Thread1 volá vlákno metodu Join()Thread2, která způsobí Thread1 , že se zablokuje, dokud Thread2 se nedokončil nebo uplynou 2 sekundy.

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

Pokud Timeout.Infinite je zadán pro timeout, tato metoda se chová stejně jako Join() přetížení metody, s výjimkou návratové hodnoty.

Pokud vlákno již ukončeno, když Join je volána, vrátí metoda okamžitě.

Tato metoda změní stav aktuálního vlákna tak, aby zahrnoval WaitSleepJoin. Nelze vyvolat Join ve vlákně, které je ve ThreadState.Unstarted stavu .

Viz také

• ThreadState