Constructeurs statiques (Guide de programmation C#)

Un constructeur statique est utilisé pour initialiser n'importe quelle donnée statique, ou pour effectuer une action particulière devant être effectuée une seule fois. Il est appelé automatiquement avant que la première instance soit créée ou que des membres statiques soient référencés.

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

Les constructeurs statiques ont les propriétés suivantes :

• Un constructeur statique n'accepte pas de modificateurs d'accès ni de paramètres.

• Un constructeur statique est appelé automatiquement pour initialiser la classe avant que la première instance soit créée ou que tous les membres statiques sont référencés.

• Il ne peut pas être appelé directement.

• L'utilisateur n'a aucun contrôle sur le moment où le constructeur statique est exécuté dans le programme.

• Exemple typique d'utilisation d'un constructeur statique : lorsque la classe utilise un fichier journal et que le constructeur est utilisé pour écrire des entrées dans ce fichier.

• Les constructeurs statiques sont également utiles lors de la création de classes wrapper pour du code non managé, lorsque le constructeur peut appeler la méthode LoadLibrary.

• Si un constructeur statique lève une exception, l'exécution ne l'appelle pas une deuxième fois et le type reste non initialisé pendant la durée de vie du domaine d'application dans lequel votre programme s'exécute.

Exemple

Dans cet exemple, la classe Bus a un constructeur static. Lorsque la première instance de Bus est créée (bus1), le constructeur static est appelé pour initialiser la classe. L'exemple de sortie vérifie que le constructeur static est exécuté une seule fois, même si deux instances de Bus sont créées, et qu'il est exécuté avant le constructeur d'instance ne le soit.

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

Voir aussi

Référence

Classes et structs (Guide de programmation C#)

Constructeurs (guide de programmation C#)

Destructeurs (Guide de programmation C#)

Concepts

Guide de programmation C#