Constructeurs statiques (Guide de programmation C#)Static Constructors (C# Programming Guide)

Un constructeur statique est utilisé pour initialiser des données statiques ou pour effectuer une action particulière qui ne doit être effectuée qu’une seule fois.A static constructor is used to initialize any static data, or to perform a particular action that needs to be performed once only. Il est automatiquement appelé avant la création de la première instance ou le référencement d’un membre statique.It is called automatically before the first instance is created or any static members are referenced.

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 :Static constructors have the following properties:

  • Un constructeur statique n’accepte pas de modificateur d’accès et n’a pas de paramètre.A static constructor does not take access modifiers or have parameters.

  • Un constructeur statique est automatiquement appelé pour initialiser la classe avant la création de la première instance ou le référencement d’un membre statique.A static constructor is called automatically to initialize the class before the first instance is created or any static members are referenced.

  • Un constructeur statique ne peut pas être appelé directement.A static constructor cannot be called directly.

  • L’utilisateur n’a aucun contrôle sur le moment d’exécution du constructeur statique dans le programme.The user has no control on when the static constructor is executed in the program.

  • Généralement, on utilise des constructeurs statiques quand la classe utilise un fichier journal et que le constructeur sert à écrire des entrées dans ce fichier.A typical use of static constructors is when the class is using a log file and the constructor is used to write entries to this file.

  • Les constructeurs statiques sont également utiles pour la création de classes wrapper pour du code non managé, quand le constructeur peut appeler la méthode LoadLibrary.Static constructors are also useful when creating wrapper classes for unmanaged code, when the constructor can call the LoadLibrary method.

  • Si un constructeur statique lève une exception, le runtime ne l’appelle pas une deuxième fois et le type reste non initialisé pour la durée de vie du domaine d’application dans lequel votre programme s’exécute.If a static constructor throws an exception, the runtime will not invoke it a second time, and the type will remain uninitialized for the lifetime of the application domain in which your program is running.

ExempleExample

Dans cet exemple, la classe Bus possède un constructeur statique.In this example, class Bus has a static constructor. Quand la première instance de Bus est créée (bus1), le constructeur statique est appelé pour initialiser la classe.When the first instance of Bus is created (bus1), the static constructor is invoked to initialize the class. L’exemple de sortie vérifie que le constructeur statique s’exécute une seule fois, même si deux instances de Bus sont créées, et qu’il s’exécute avant le constructeur d’instance.The sample output verifies that the static constructor runs only one time, even though two instances of Bus are created, and that it runs before the instance constructor runs.

 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.Milliseconds,
                                 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 aussiSee Also