Application.Exit Método

Definição

Informa todos os aumentos de mensagem que devem encerrar e, em seguida, fecha todas as janelas de aplicativo após as mensagens terem sido processadas.

Sobrecargas

Exit()

Informa todos os aumentos de mensagem que devem encerrar e, em seguida, fecha todas as janelas de aplicativo após as mensagens terem sido processadas.

Exit(CancelEventArgs)

Informa todos os aumentos de mensagem que devem encerrar e, em seguida, fecha todas as janelas de aplicativo após as mensagens terem sido processadas.

Exit()

Informa todos os aumentos de mensagem que devem encerrar e, em seguida, fecha todas as janelas de aplicativo após as mensagens terem sido processadas.

public static void Exit ();

Exemplos

O exemplo de código a seguir lista os números em uma caixa de listagem em um formulário. Cada vez que você clica button1em , o aplicativo adiciona outro número à lista.

O Main método chama Run para iniciar o aplicativo, que cria o formulário, listBox1e button1. Quando o usuário clica button1em , o button1_Click método adiciona os números um a três à caixa de listagem e exibe um MessageBox. Se o usuário clicar em Não no MessageBox, o button1_Click método adicionará outro número à lista. Se o usuário clicar em Sim, o aplicativo chamará Exit, para processar todas as mensagens restantes na fila e sair.

O exemplo requer isso listBox1 e button1 foram instanciados e colocados em um formulário.

public static void Main(string[] args) {
    // Starts the application.
    Application.Run(new Form1());
 }

 private void button1_Click(object sender, System.EventArgs e) {
    // Populates a list box with three numbers.
    int i = 3;
    for(int j=1; j<=i; j++) {
       listBox1.Items.Add(j);
    }

    /* Determines whether the user wants to exit the application.
     * If not, adds another number to the list box. */
    while (MessageBox.Show("Exit application?", "", MessageBoxButtons.YesNo) ==
       DialogResult.No) {
       // Increments the counter ands add the number to the list box.
       i++;
       listBox1.Items.Add(i);
    }

    // The user wants to exit the application. Close everything down.
    Application.Exit();
 }

Comentários

O Exit método interrompe todos os loops de mensagem em execução em todos os threads e fecha todas as janelas do aplicativo. Esse método não força necessariamente a saída do aplicativo. O Exit método normalmente é chamado de dentro de um loop de mensagem e força Run o retorno. Para sair de um loop de mensagem somente para o thread atual, chame ExitThread.

Exit gera os seguintes eventos e executa as ações condicionais associadas:

  • Um FormClosing evento é gerado para cada formulário representado pela OpenForms propriedade . Esse evento pode ser cancelado definindo a Cancel propriedade de seu FormClosingEventArgs parâmetro como true.

  • Se um dos manipuladores cancelar o evento, retornará Exit sem mais ações. Caso contrário, um FormClosed evento será gerado para cada formulário aberto e, em seguida, todos os loops e formulários de mensagem em execução serão fechados.

Nota

O Exit método não gera os Closed eventos eClosing, que são obsoletos a partir de .NET Framework 2.0.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Exit(CancelEventArgs)

Informa todos os aumentos de mensagem que devem encerrar e, em seguida, fecha todas as janelas de aplicativo após as mensagens terem sido processadas.

public static void Exit (System.ComponentModel.CancelEventArgs e);
public static void Exit (System.ComponentModel.CancelEventArgs? e);

Parâmetros

e
CancelEventArgs

Retorna se qualquer Form dentro do aplicativo cancelou a saída.

Confira também

Aplica-se a

.NET Framework 4.8.1 e outras versões
Produto Versões
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9