Construtores estáticos (Guia de Programação em C#)

Um construtor estático é usado para inicializar qualquer estático dados, ou executar uma ação específica que precisa ser executada apenas uma vez. Ele é chamado automaticamente antes da primeira instância é criada ou quaisquer membros estáticos são referenciados.

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

Construtores estáticos têm as seguintes propriedades:

• Um construtor estático não levar modificadores de acesso ou ter parâmetros.

• Um construtor estático é chamado automaticamente ao inicializar o classe antes da primeira instância é criada ou quaisquer membros estáticos são referenciados.

• Um construtor estático não pode ser chamado diretamente.

• O usuário não tem controle sobre quando o construtor estático é executado no programa.

• Um uso típico de construtores estáticos é quando a classe está usando um arquivo de log e o construtor é usado para gravar entradas para este arquivo.

• Construtores estáticos também são úteis ao criar classes de wrapper para código não gerenciado, quando o construtor pode chamar o LoadLibrary método.

• Se um construtor estático lança uma exceção, o runtime não invocará uma segunda vez e o tipo permanecerão não inicializado para o tempo de vida do domínio do aplicativo no qual o programa é executado.

Exemplo

Neste exemplo, a classe Bus tem um construtor estático. Quando a primeira instância de Bus é criado (bus1), o construtor estático é chamado para inicializar a classe. A saída de exemplo verifica que o construtor estático executa somente uma vez, mesmo que duas instâncias do Bus são criados, e ele é executado antes da execução do construtor de instância.

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

Consulte também

Referência

Classes e structs (Guia de Programação em C#)

Construtores (Guia de Programação em C#)

Classes static e membros de classes static (Guia de Programação em C#)

Destruidores (Guia de Programação em C#)

Conceitos

Guia de Programação em C#