static (Referência de C#)

Esta página aborda a palavra-chave do modificador static. A palavra-chave static também faz parte da diretiva using static.

Use o modificador static para declarar um membro estático que pertença ao próprio tipo, em vez de um objeto específico. O modificador static pode ser usado para declarar classes static. Em classes, interfaces e structs, você pode adicionar o modificador static a campos, métodos, propriedades, operadores, eventos e construtores. O modificador static não pode ser usado com indexadores ou finalizadores. Para obter mais informações, consulte Classes estáticas e membros de classes estáticas.

Você pode adicionar o modificador static a uma função local. Uma função local estática não pode capturar variáveis locais ou o estado da instância.

A partir do C# 9.0, você pode adicionar o modificador static a uma expressão lambda ou método anônimo. Um método anônimo estático não pode capturar variáveis locais ou o estado da instância entre escopos.

Exemplo: classe estática

A seguinte classe é declarada como static e contém apenas métodos static:

static class CompanyEmployee
{
    public static void DoSomething() { /*...*/ }
    public static void DoSomethingElse() { /*...*/  }
}

Uma constante ou declaração de tipo é, implicitamente, um membro static. Um membro static não pode ser referenciado por meio de uma instância. Em vez disso, ele é referenciado pelo nome do tipo. Por exemplo, considere a seguinte classe:

public class MyBaseC
{
    public struct MyStruct
    {
        public static int x = 100;
    }
}

Para fazer referência ao x do membro static, use o nome totalmente qualificado MyBaseC.MyStruct.x, a menos que o membro esteja acessível a partir do mesmo escopo:

Console.WriteLine(MyBaseC.MyStruct.x);

Embora uma instância de uma classe contenha uma cópia separada de todos os campos de instância da classe, há apenas uma cópia de cada campo static.

Não é possível usar this para referenciar métodos static ou acessadores de propriedade.

Se a palavra-chave static for aplicada a uma classe, todos os membros da classe deverão ser static.

Classes, interfaces e classes static podem ter construtores static. Um construtor static é chamado em algum ponto entre o momento em que o programa é iniciado e a classe é instanciada.

Observação

A palavra-chave static tem utilizações mais limitadas do que no C++. Para comparar com a palavra-chave do C++, consulte Storage classes (C++) (Classes de armazenamento (C++)).

Para demonstrar os membros static, considere uma classe que representa um funcionário da empresa. Suponha que a classe contém um método para contar funcionários e um campo para armazenar o número de funcionários. O método e o campo não pertencem a nenhuma instância de funcionário. Em vez disso, eles pertencem à classe de funcionários como um todo. Portanto, eles devem ser declarados como membros static da classe.

Exemplo: campo e método estático

Este exemplo lê o nome e a ID de um novo funcionário, incrementa o contador de funcionário em um e exibe as informações do novo funcionário e do novo número de funcionários. Esse programa lê, do teclado, o número atual de funcionários.

public class Employee4
{
    public string id;
    public string name;

    public Employee4()
    {
    }

    public Employee4(string name, string id)
    {
        this.name = name;
        this.id = id;
    }

    public static int employeeCounter;

    public static int AddEmployee()
    {
        return ++employeeCounter;
    }
}

class MainClass : Employee4
{
    static void Main()
    {
        Console.Write("Enter the employee's name: ");
        string name = Console.ReadLine();
        Console.Write("Enter the employee's ID: ");
        string id = Console.ReadLine();

        // Create and configure the employee object.
        Employee4 e = new Employee4(name, id);
        Console.Write("Enter the current number of employees: ");
        string n = Console.ReadLine();
        Employee4.employeeCounter = Int32.Parse(n);
        Employee4.AddEmployee();

        // Display the new information.
        Console.WriteLine($"Name: {e.name}");
        Console.WriteLine($"ID:   {e.id}");
        Console.WriteLine($"New Number of Employees: {Employee4.employeeCounter}");
    }
}
/*
Input:
Matthias Berndt
AF643G
15
 *
Sample Output:
Enter the employee's name: Matthias Berndt
Enter the employee's ID: AF643G
Enter the current number of employees: 15
Name: Matthias Berndt
ID:   AF643G
New Number of Employees: 16
*/

Exemplo: inicialização estática

Este exemplo mostra que você pode inicializar um campo static usando outro campo static que ainda não foi declarado. Os resultados serão indefinidos até que você atribua explicitamente um valor ao static campo.

class Test
{
    static int x = y;
    static int y = 5;

    static void Main()
    {
        Console.WriteLine(Test.x);
        Console.WriteLine(Test.y);

        Test.x = 99;
        Console.WriteLine(Test.x);
    }
}
/*
Output:
    0
    5
    99
*/

Especificação da linguagem C#

Para obter mais informações, consulte a Especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso de C#.

Confira também