Construtores estáticos (Guia de Programação em C#)Static Constructors (C# Programming Guide)

Um construtor estático é usado para inicializar quaisquer dados estáticos ou para executar uma ação específica que precisa ser executada apenas uma vez.A static constructor is used to initialize any static data, or to perform a particular action that needs to be performed once only. Ele é chamado automaticamente antes que a primeira instância seja criada ou que quaisquer membros estáticos sejam referenciados.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;
    }
}

ComentáriosRemarks

Construtores estáticos têm as seguintes propriedades:Static constructors have the following properties:

  • Um construtor estático não usa modificadores de acesso nem tem parâmetros.A static constructor does not take access modifiers or have parameters.

  • Uma classe ou struct só pode ter um construtor estático.A class or struct can only have one static constructor.

  • Os construtores estáticos não podem ser herdados ou sobrecarregados.Static constructors cannot be inherited or overloaded.

  • Um construtor estático não pode ser chamado diretamente e destina-se apenas a ser chamado pela Common Language Runtime (CLR).A static constructor cannot be called directly and is only meant to be called by the common language runtime (CLR). Ele é invocado automaticamente.It is invoked automatically.

  • O usuário não tem controle sobre quando o construtor estático é executado no programa.The user has no control on when the static constructor is executed in the program.

  • Um construtor estático é chamado automaticamente para inicializar a classe antes que a primeira instância seja criada ou que quaisquer membros estáticos sejam referenciados.A static constructor is called automatically to initialize the class before the first instance is created or any static members are referenced. Um construtor estático será executado antes de um construtor de instância.A static constructor will run before an instance constructor. Observe que um construtor de tipo estático é chamado quando um método estático atribuído a um evento ou um delegado é invocado, e não quando ele é atribuído.Note that a type's static constructor is called when a static method assigned to an event or a delegate is invoked and not when it is assigned. Se os inicializadores de variável de campo estático estiverem presentes na classe do construtor estático, eles serão executados na ordem textual na qual eles aparecem na declaração de classe imediatamente antes da execução do construtor estático.If static field variable initializers are present in the class of the static constructor, they will be executed in the textual order in which they appear in the class declaration immediately prior to the execution of the static constructor.

  • Se você não fornecer um construtor estático para inicializar campos estáticos, todos os campos estáticos serão inicializados com seu valor padrão, conforme listado na Tabela de Valores Padrão.If you don't provide a static constructor to initialize static fields, all static fields are initialized to their default value as listed in the Default Values Table.

  • Se um construtor estático gera uma exceção, o tempo de execução não o invocará uma segunda vez e o tipo permanecerá não inicializado durante o tempo de vida do domínio do aplicativo no qual o programa está sendo executado.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. Normalmente, uma exceção TypeInitializationException é lançada quando um construtor estático não consegue instanciar um tipo ou uma exceção sem tratamento que ocorre em um construtor estático.Most commonly, a TypeInitializationException exception is thrown when a static constructor is unable to instantiate a type or for an unhandled exception occurring within a static constructor. Para construtores estáticos implícitos que não são definidos explicitamente no código-fonte, a solução de problemas pode exigir inspeção do código de linguagem intermediária (IL).For implicit static constructors that are not explicitly defined in source code, troubleshooting may require inspection of the intermediate language (IL) code.

  • A presença de um construtor estático impede a adição do atributo do tipo BeforeFieldInit.The presence of a static constructor prevents the addition of the BeforeFieldInit type attribute. Isso limita a otimização do tempo de execução.This limits runtime optimization.

  • Um campo declarado como static readonly só pode ser atribuído como parte de sua declaração ou em um construtor estático.A field declared as static readonly may only be assigned as part of its declaration or in a static constructor. Quando um construtor estático explícito não for necessário, inicialize os campos estáticos na declaração, em vez de usar um construtor estático para melhorar a otimização do tempo de execução.When an explicit static constructor is not required, initialize static fields at declaration, rather than through a static constructor for better runtime optimization.

Observação

Embora não seja diretamente acessível, a presença de um construtor estático explícito deve ser documentada para auxiliar na solução de problemas de exceções de inicialização.Though not directly accessible, the presence of an explicit static constructor should be documented to assist with troubleshooting initialization exceptions.

UsoUsage

  • Um uso típico de construtores estáticos é quando a classe está usando um arquivo de log e o construtor é usado para gravar entradas nesse arquivo.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.

  • Construtores estáticos também são úteis ao criar classes wrapper para código não gerenciado quando o construtor pode chamar o método LoadLibrary.Static constructors are also useful when creating wrapper classes for unmanaged code, when the constructor can call the LoadLibrary method.

  • Os construtores estáticos também são um local conveniente para impor verificações em tempo de execução no parâmetro de tipo que não pode ser verificado em tempo de compilação por meio de restrições (restrições de parâmetro de tipo).Static constructors are also a convenient place to enforce run-time checks on the type parameter that cannot be checked at compile-time via constraints (Type parameter constraints).

ExemploExample

Nesse exemplo, a classe Bus tem um construtor estático.In this example, class Bus has a static constructor. Quando a primeira instância do Bus for criada (bus1), o construtor estático será invocado para inicializar a classe.When the first instance of Bus is created (bus1), the static constructor is invoked to initialize the class. O exemplo de saída verifica se o construtor estático é executado somente uma vez, mesmo se duas instâncias de Bus forem criadas e se é executado antes que o construtor da instância seja executado.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.      
*/

Especificação da linguagem C#C# language specification

Para saber mais, confira a seção Construtores estáticos da Especificação da linguagem C#.For more information, see the Static constructors section of the C# language specification.

Consulte tambémSee also