Statische Konstruktoren (C#-Programmierhandbuch)

Ein statischer Konstruktor wird verwendet, um static-Daten zu initialisieren oder um eine einmalige Handlung auszuführen. Er wird automatisch aufgerufen, bevor die erste Instanz erstellt oder auf statische Member verwiesen wird.

class SimpleClass
{
    // Static variable that must be initialized at run time.
    static readonly long baseline;

    // Static constructor is called at most one time, before any
    // instance constructor is invoked or member is accessed.
    static SimpleClass()
    {
        baseline = DateTime.Now.Ticks;
    }
}

Statische Konstruktoren verfügen über die folgenden Eigenschaften:

• Ein statischer Konstruktor akzeptiert weder Zugriffsmodifizierer, noch besitzt er Parameter.

• Er wird automatisch zur Initialisierung der Klasse aufgerufen, bevor die erste Instanz erstellt oder auf beliebige statische Member verwiesen wird.

• Ein statischer Konstruktor kann nicht direkt aufgerufen werden.

• Der Benutzer kann nicht steuern, wann der statische Konstruktor im Programm ausgeführt wird.

• Meistens wird ein statischer Konstruktor verwendet, wenn die Klasse eine Protokolldatei verwendet und mithilfe des Konstruktors Einträge in diese Datei vorgenommen werden.

• Statische Konstruktoren sind auch beim Erstellen von Wrapperklassen für nicht verwalteten Code nützlich, wenn der Konstruktor die LoadLibrary-Methode aufrufen kann.

• Wenn ein statischer Konstrukter eine Ausnahme aulöst, wird er zur Laufzeit nicht wieder aufgerufen und der Typ bleibt für die Lebensdauer der Anwendungsdomäne, in der das Programm ausgeführt wird, uninitialisiert.

Beispiel

Die Bus-Klasse in diesem Beispiel verfügt über einen statischen Konstruktor. Wenn die erste Instanz von Bus (bus1) erstellt wird, wird der statische Konstruktor aufgerufen, um die Klasse zu initialisieren. Die Beispielausgabe überprüft, ob der statische Konstruktor nur einmal ausgeführt wird, obwohl zwei Instanzen von Bus erstellt werden. Ferner wird überprüft, ob der Konstruktor vor dem Instanzenkonstruktor ausgeführt wird.

    public class Bus
    {
        // Static variable used by all Bus instances.
        // Represents the time the first bus of the day starts its route.
        protected static readonly DateTime globalStartTime;

        // Property for the number of each bus.
        protected int RouteNumber { get; set; }

        // Static constructor to initialize the static variable.
        // It is invoked before the first instance constructor is run.
        static Bus()
        {
            globalStartTime = DateTime.Now;

            // The following statement produces the first line of output, 
            // and the line occurs only once.
            Console.WriteLine("Static constructor sets global start time to {0}",
                globalStartTime.ToLongTimeString());
        }

        // Instance constructor.
        public Bus(int routeNum)
        {
            RouteNumber = routeNum;
            Console.WriteLine("Bus #{0} is created.", RouteNumber);
        }

        // Instance method.
        public void Drive()
        {
            TimeSpan elapsedTime = DateTime.Now - globalStartTime;

            // For demonstration purposes we treat milliseconds as minutes to simulate
            // actual bus times. Do not do this in your actual bus schedule program!
            Console.WriteLine("{0} is starting its route {1:N2} minutes after global start time {2}.",
                                    this.RouteNumber,
                                    elapsedTime.TotalMilliseconds,
                                    globalStartTime.ToShortTimeString());
        }
    }

    class TestBus
    {
        static void Main()
        {
            // The creation of this instance activates the static constructor.
            Bus bus1 = new Bus(71);

            // Create a second bus.
            Bus bus2 = new Bus(72);

            // Send bus1 on its way.
            bus1.Drive();

            // Wait for bus2 to warm up.
            System.Threading.Thread.Sleep(25);

            // Send bus2 on its way.
            bus2.Drive();

            // Keep the console window open in debug mode.
            System.Console.WriteLine("Press any key to exit.");
            System.Console.ReadKey();
        }
    }
    /* Sample output:
        Static constructor sets global start time to 3:57:08 PM.
        Bus #71 is created.
        Bus #72 is created.
        71 is starting its route 6.00 minutes after global start time 3:57 PM.
        72 is starting its route 31.00 minutes after global start time 3:57 PM.      
   */

Siehe auch

Referenz

Klassen und Strukturen (C#-Programmierhandbuch)

Konstruktoren (C#-Programmierhandbuch)

Destruktoren (C#-Programmierhandbuch)

Konzepte

C#-Programmierhandbuch