Thread.IsBackground Eigenschaft

Definition

Namespace:

System.Threading

Assemblys:

netstandard.dll, System.Threading.Thread.dll

Quelle:

Thread.CoreCLR.cs

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob ein Thread ein Hintergrundthread ist.

public:
 property bool IsBackground { bool get(); void set(bool value); };

public bool IsBackground { get; set; }

member this.IsBackground : bool with get, set

Public Property IsBackground As Boolean

Eigenschaftswert

Boolean

truewenn dieser Thread zu einem Hintergrundthread wird oder ist; andernfalls . false

Ausnahmen

ThreadStateException

Der Thread ist tot.

Beispiele

Im folgenden Beispiel wird das Verhalten von Vordergrund- und Hintergrundthreads kontrastiert. Er erstellt einen Vordergrundthread und einen Hintergrundthread. Der Vordergrundthread wird ausgeführt, bis die for Schleife abgeschlossen und beendet wird. Wie die Ausgabe aus dem Beispiel zeigt, weil der Vordergrundthread die Ausführung abgeschlossen hat, wird der Prozess beendet, bevor der Hintergrundthread die Ausführung abgeschlossen hat.

using System;
using System.Threading;

class Example
{
    static void Main()
    {
        BackgroundTest shortTest = new BackgroundTest(10);
        Thread foregroundThread = 
            new Thread(new ThreadStart(shortTest.RunLoop));

        BackgroundTest longTest = new BackgroundTest(50);
        Thread backgroundThread = 
            new Thread(new ThreadStart(longTest.RunLoop));
        backgroundThread.IsBackground = true;

        foregroundThread.Start();
        backgroundThread.Start();
    }
}

class BackgroundTest
{
    int maxIterations;

    public BackgroundTest(int maxIterations)
    {
        this.maxIterations = maxIterations;
    }

    public void RunLoop()
    {
        for (int i = 0; i < maxIterations; i++) {
            Console.WriteLine("{0} count: {1}", 
                Thread.CurrentThread.IsBackground ? 
                   "Background Thread" : "Foreground Thread", i);
            Thread.Sleep(250);
        }
        Console.WriteLine("{0} finished counting.", 
                          Thread.CurrentThread.IsBackground ? 
                          "Background Thread" : "Foreground Thread");
    }
}
// The example displays output like the following:
//    Foreground Thread count: 0
//    Background Thread count: 0
//    Background Thread count: 1
//    Foreground Thread count: 1
//    Foreground Thread count: 2
//    Background Thread count: 2
//    Foreground Thread count: 3
//    Background Thread count: 3
//    Background Thread count: 4
//    Foreground Thread count: 4
//    Foreground Thread count: 5
//    Background Thread count: 5
//    Foreground Thread count: 6
//    Background Thread count: 6
//    Background Thread count: 7
//    Foreground Thread count: 7
//    Background Thread count: 8
//    Foreground Thread count: 8
//    Foreground Thread count: 9
//    Background Thread count: 9
//    Background Thread count: 10
//    Foreground Thread count: 10
//    Background Thread count: 11
//    Foreground Thread finished counting.

open System.Threading

type BackgroundTest(maxIterations) =
    member _.RunLoop() =
        for i = 0 to maxIterations - 1 do
            printfn
                $"""{if Thread.CurrentThread.IsBackground then
                         "Background Thread"
                     else
                         "Foreground Thread"} count: {i}"""

            Thread.Sleep 250

        printfn
            $"""{if Thread.CurrentThread.IsBackground then
                     "Background Thread"
                 else
                     "Foreground Thread"} finished counting."""

let shortTest = BackgroundTest 10
let foregroundThread = Thread shortTest.RunLoop

let longTest = BackgroundTest 50
let backgroundThread = Thread longTest.RunLoop
backgroundThread.IsBackground <- true

foregroundThread.Start()
backgroundThread.Start()

// The example displays output like the following:
//    Foreground Thread count: 0
//    Background Thread count: 0
//    Background Thread count: 1
//    Foreground Thread count: 1
//    Foreground Thread count: 2
//    Background Thread count: 2
//    Foreground Thread count: 3
//    Background Thread count: 3
//    Background Thread count: 4
//    Foreground Thread count: 4
//    Foreground Thread count: 5
//    Background Thread count: 5
//    Foreground Thread count: 6
//    Background Thread count: 6
//    Background Thread count: 7
//    Foreground Thread count: 7
//    Background Thread count: 8
//    Foreground Thread count: 8
//    Foreground Thread count: 9
//    Background Thread count: 9
//    Background Thread count: 10
//    Foreground Thread count: 10
//    Background Thread count: 11
//    Foreground Thread finished counting.

Imports System.Threading

Public Module Example
    Public Sub Main()
        Dim shortTest As New BackgroundTest(10)
        Dim foregroundThread As New Thread(AddressOf shortTest.RunLoop)

        Dim longTest As New BackgroundTest(50)
        Dim backgroundThread As New Thread(AddressOf longTest.RunLoop)
        backgroundThread.IsBackground = True

        foregroundThread.Start()
        backgroundThread.Start()
    End Sub
End Module

Public Class BackgroundTest
    Dim maxIterations As Integer 

    Sub New(maximumIterations As Integer)
        maxIterations = maximumIterations
    End Sub

    Sub RunLoop()
        For i As Integer = 0 To maxIterations
            Console.WriteLine("{0} count: {1}", _
                    If(Thread.CurrentThread.IsBackground, 
                       "Background Thread", "Foreground Thread"), i)
            Thread.Sleep(250)
        Next 

        Console.WriteLine("{0} finished counting.", 
                          If(Thread.CurrentThread.IsBackground, 
                          "Background Thread", "Foreground Thread"))
    End Sub
End Class
' The example displays output like the following:
'    Foreground Thread count: 0
'    Background Thread count: 0
'    Background Thread count: 1
'    Foreground Thread count: 1
'    Foreground Thread count: 2
'    Background Thread count: 2
'    Foreground Thread count: 3
'    Background Thread count: 3
'    Background Thread count: 4
'    Foreground Thread count: 4
'    Foreground Thread count: 5
'    Background Thread count: 5
'    Foreground Thread count: 6
'    Background Thread count: 6
'    Background Thread count: 7
'    Foreground Thread count: 7
'    Background Thread count: 8
'    Foreground Thread count: 8
'    Foreground Thread count: 9
'    Background Thread count: 9
'    Background Thread count: 10
'    Foreground Thread count: 10
'    Background Thread count: 11
'    Foreground Thread finished counting.

Hinweise

Ein Thread ist entweder ein Hintergrundthread oder ein Vordergrundthread. Hintergrundthreads sind identisch mit Vordergrundthreads, mit der Ausnahme, dass Hintergrundthreads nicht verhindern, dass ein Prozess beendet wird. Sobald alle Vordergrundthreads, die zu einem Prozess gehören, beendet wurden, beendet die Common Language Runtime den Prozess. Alle verbleibenden Hintergrundthreads werden beendet und nicht abgeschlossen.

Standardmäßig werden die folgenden Threads im Vordergrund ausgeführt (d. r. deren IsBackground Eigenschaft wird zurückgegeben false):

• Der primäre Thread (oder Hauptanwendungsthread).

• Alle Threads, die durch Aufrufen eines Thread Klassenkonstruktors erstellt wurden.

Standardmäßig werden die folgenden Threads im Hintergrund ausgeführt (d. r. deren IsBackground Eigenschaft gibt folgendes zurück true):

• Threadpoolthreads, die ein Pool von Arbeitsthreads sind, die von der Laufzeit verwaltet werden. Sie können den Threadpool konfigurieren und die Arbeit an Threadpoolthreads mithilfe der ThreadPool Klasse planen.

  Hinweis

  Aufgabenbasierte asynchrone Vorgänge werden automatisch in Threadpoolthreads ausgeführt.

• Alle Threads, die aus nicht verwaltetem Code in die verwaltete Ausführungsumgebung gelangen.

Weitere Informationen

• Vordergrund- und Hintergrundthreads