Statické konstruktory (Příručka programování C#)

Statický konstruktor slouží k inicializaci žádné statické dat, nebo k provedení konkrétní akce, která stačí provést pouze jednou.Je volána automaticky vytváří první instance nebo jsou odkazovány žádným statickým členům.

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;
    }
}

Statické konstruktory mají následující vlastnosti:

• Statický konstruktor trvat modifikátory přístupu nebo mít parametry.

• Statický konstruktor automaticky volána k inicializaci třídy před první instance je vytvořen nebo jsou odkazovány žádným statickým členům.

• Statický konstruktor nemůže být volán přímo.

• Uživatel nemá kontrolu na provedení statického konstruktoru v programu.

• Typické použití statické konstruktory je třída používá soubor protokolu a konstruktor se používá k zápisu položky do tohoto souboru.

• Statické konstruktory jsou také užitečné při tvorbě tříd obálky pro nespravovaný kód můžete volat konstruktor LoadLibrary metoda.

• Pokud statický konstruktor výjimku, runtime bude vyvolat podruhé a typ zůstanou neinicializované dobu existence domény aplikace, ve kterém je spuštěn program.

Příklad

V tomto příkladu třídy Bus obsahuje statický konstruktor.Při první výskyt Bus je vytvořen (bus1), je vyvolána statický konstruktor třídy inicializace.Ukázkový výstup ověří, že statický konstruktor spouští jen jednou, přestože dvě instance Bus jsou vytvořeny a jeho spuštění před spustí konstruktor instance.

    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.      
   */

Viz také

Referenční dokumentace

Třídy a struktur (Příručka programování C#)

Konstruktory (Příručka programování C#)

Statické třídy a členy statických tříd (Příručka programování C#)

Destruktory (Příručka programování C#)

Koncepty

Příručka programování C#