Application Clase

Definición

Proporciona static métodos y propiedades para administrar una aplicación, como métodos para iniciar y detener una aplicación, procesar Windows mensajes y propiedades para obtener información sobre una aplicación. Esta clase no puede heredarse.

public ref class Application sealed
public sealed class Application
type Application = class
Public NotInheritable Class Application
Herencia
Application

Ejemplos

En el ejemplo de código siguiente se enumeran los números de un cuadro de lista de un formulario. Cada vez que haga clic en button1, la aplicación agrega otro número a la lista.

El Main método llama Run a para iniciar la aplicación, que crea el formulario listBox1 y button1. Cuando el usuario hace button1clic en , el button1_Click método muestra un MessageBox. Si el usuario hace No clic en MessageBox, el button1_Click método agrega un número a la lista. Si el usuario hace clic en Yes, la aplicación llama Exit a para procesar todos los mensajes restantes de la cola y, a continuación, para salir.

Note

La llamada a Exit producirá un error en la confianza parcial.

public ref class Form1: public System::Windows::Forms::Form
{
private:
   Button^ button1;
   ListBox^ listBox1;

public:
   Form1()
   {
      button1 = gcnew Button;
      button1->Left = 200;
      button1->Text =  "Exit";
      button1->Click += gcnew EventHandler( this, &Form1::button1_Click );
      listBox1 = gcnew ListBox;
      this->Controls->Add( button1 );
      this->Controls->Add( listBox1 );
   }

private:
   void Form1::button1_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      int count = 1;
      
      // Check to see whether the user wants to exit 
      // the application. If not, add a number to the list box.
      while ( MessageBox::Show(  "Exit application?",  "", MessageBoxButtons::YesNo ) == ::DialogResult::No )
      {
         listBox1->Items->Add( count );
         count += 1;
      }

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

};

int main()
{
   
   // Starts the application.
   Application::Run( gcnew Form1 );
}
public class Form1 : Form
{
    [STAThread]
    public static void Main()
    {
        // Start the application.
        Application.Run(new Form1());
    }

    private Button button1;
    private ListBox listBox1;

    public Form1()
    {
        button1 = new Button();
        button1.Left = 200;
        button1.Text = "Exit";
        button1.Click += new EventHandler(button1_Click);

        listBox1 = new ListBox();
        this.Controls.Add(button1);
        this.Controls.Add(listBox1);
    }

    private void button1_Click(object sender, System.EventArgs e)
    {
        int count = 1;
        // Check to see whether the user wants to exit the application.
        // If not, add a number to the list box.
        while (MessageBox.Show("Exit application?", "",
            MessageBoxButtons.YesNo)==DialogResult.No)
        {
            listBox1.Items.Add(count);
            count += 1;
        }

        // The user wants to exit the application.
        // Close everything down.
        Application.Exit();
    }
}
Public Class Form1 
    Inherits Form

    <STAThread()> _
     Shared Sub Main()
        ' Start the application.
        Application.Run(New Form1)
    End Sub

    Private WithEvents button1 As Button
    Private WithEvents listBox1 As ListBox

    Public Sub New()
        button1 = New Button
        button1.Left = 200
        button1.Text = "Exit"

        listBox1 = New ListBox
        Me.Controls.Add(button1)
        Me.Controls.Add(listBox1)
    End Sub

    Private Sub button1_Click(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles button1.Click
        Dim count As Integer = 1
        ' Check to see whether the user wants to exit the application.
        ' If not, add a number to the list box.
        While (MessageBox.Show("Exit application?", "", _
            MessageBoxButtons.YesNo) = DialogResult.No)

            listBox1.Items.Add(count)
            count += 1

        End While

        ' The user wants to exit the application. 
        ' Close everything down.
        Application.Exit()
    End Sub

End Class

Comentarios

La clase />

  • Run inicia un bucle de mensajes de aplicación en el subproceso actual y, opcionalmente, hace que un formulario sea visible.

  • Exit o ExitThread detiene un bucle de mensajes.

  • DoEvents procesa mensajes mientras el programa está en un bucle.

  • AddMessageFilter agrega un filtro de mensajes a la bomba de mensajes de la aplicación para supervisar Windows mensajes.

  • IMessageFilter permite impedir que se genere un evento o realice operaciones especiales antes de invocar un controlador de eventos.

Esta clase tiene CurrentCulture propiedades y CurrentInputLanguage para obtener o establecer información de referencia cultural para el subproceso actual.

No se puede crear una instancia de esta clase.

Propiedades

Nombre Description
AllowQuit

Obtiene un valor que indica si el autor de la llamada puede salir de esta aplicación.

CommonAppDataPath

Obtiene la ruta de acceso de los datos de la aplicación que se comparten entre todos los usuarios.

CommonAppDataRegistry

Obtiene la clave del Registro para los datos de la aplicación que se comparten entre todos los usuarios.

CompanyName

Obtiene el nombre de la compañía asociado a la aplicación.

CurrentCulture

Obtiene o establece la información de referencia cultural del subproceso actual.

CurrentInputLanguage

Obtiene o establece el idioma de entrada actual para el subproceso actual.

ExecutablePath

Obtiene la ruta de acceso del archivo ejecutable que inició la aplicación, incluido el nombre del archivo ejecutable.

LocalUserAppDataPath

Obtiene la ruta de acceso de los datos de la aplicación de un usuario local que no es móvil.

MessageLoop

Obtiene un valor que indica si existe un bucle de mensajes en este subproceso.

OpenForms

Obtiene una colección de formularios abiertos propiedad de la aplicación.

ProductName

Obtiene el nombre del producto asociado a esta aplicación.

ProductVersion

Obtiene la versión del producto asociada a esta aplicación.

RenderWithVisualStyles

Obtiene un valor que especifica si la aplicación actual está dibujando controles con estilos visuales.

SafeTopLevelCaptionFormat

Obtiene o establece la cadena de formato que se va a aplicar a los títulos de ventana de nivel superior cuando se muestran con un banner de advertencia.

StartupPath

Obtiene la ruta de acceso del archivo ejecutable que inició la aplicación, no incluido el nombre del archivo ejecutable.

UserAppDataPath

Obtiene la ruta de acceso de los datos de la aplicación de un usuario.

UserAppDataRegistry

Obtiene la clave del Registro para los datos de la aplicación de un usuario.

UseWaitCursor

Obtiene o establece si el cursor de espera se usa para todos los formularios abiertos de la aplicación.

VisualStyleState

Obtiene un valor que especifica cómo se aplican los estilos visuales a las ventanas de aplicación.

Métodos

Nombre Description
AddMessageFilter(IMessageFilter)

Agrega un filtro de mensajes para supervisar Windows mensajes a medida que se enrutan a sus destinos.

DoEvents()

Procesa todos los mensajes Windows actualmente en la cola de mensajes.

EnableVisualStyles()

Habilita los estilos visuales de la aplicación.

Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
Exit()

Informa a todas las bombas de mensajes que deben finalizar y, a continuación, cierra todas las ventanas de aplicación después de procesar los mensajes.

Exit(CancelEventArgs)

Informa a todas las bombas de mensajes que deben finalizar y, a continuación, cierra todas las ventanas de aplicación después de procesar los mensajes.

ExitThread()

Sale del bucle de mensajes en el subproceso actual y cierra todas las ventanas del subproceso.

FilterMessage(Message)

Ejecuta los filtros en un mensaje de ventana y devuelve una copia del mensaje modificado.

GetHashCode()

Actúa como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
OleRequired()

Inicializa OLE en el subproceso actual.

OnThreadException(Exception)

Genera el evento ThreadException.

RaiseIdle(EventArgs)

Genera el Idle evento en escenarios hospedados.

RegisterMessageLoop(Application+MessageLoopCallback)

Registra una devolución de llamada para comprobar si el bucle de mensajes se ejecuta en entornos hospedados.

RemoveMessageFilter(IMessageFilter)

Quita un filtro de mensaje de la bomba de mensajes de la aplicación.

Restart()

Cierra la aplicación e inicia inmediatamente una nueva instancia.

Run()

Comienza a ejecutar un bucle de mensajes de aplicación estándar en el subproceso actual, sin un formulario.

Run(ApplicationContext)

Comienza a ejecutar un bucle de mensajes de aplicación estándar en el subproceso actual, con un ApplicationContext.

Run(Form)

Comienza a ejecutar un bucle de mensajes de aplicación estándar en el subproceso actual y hace que el formulario especificado sea visible.

SetCompatibleTextRenderingDefault(Boolean)

Establece el valor predeterminado de toda la aplicación para la UseCompatibleTextRendering propiedad definida en determinados controles.

SetSuspendState(PowerState, Boolean, Boolean)

Suspende o hiberna el sistema o solicita que el sistema se suspenda o hiberna.

SetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)

Indica a la aplicación cómo responder a excepciones no controladas, aplicando opcionalmente un comportamiento específico del subproceso.

SetUnhandledExceptionMode(UnhandledExceptionMode)

Indica a la aplicación cómo responder a excepciones no controladas.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
UnregisterMessageLoop()

Anula el registro de la devolución de llamada de bucle de mensajes realizada con RegisterMessageLoop(Application+MessageLoopCallback).

Eventos

Nombre Description
ApplicationExit

Se produce cuando la aplicación está a punto de apagarse.

EnterThreadModal

Se produce cuando la aplicación está a punto de especificar un estado modal.

Idle

Se produce cuando la aplicación finaliza el procesamiento y está a punto de entrar en el estado de inactividad.

LeaveThreadModal

Se produce cuando la aplicación está a punto de dejar un estado modal.

ThreadException

Se produce cuando se produce una excepción de subproceso sintratrar.

ThreadExit

Se produce cuando un subproceso está a punto de apagarse. Cuando el subproceso principal de una aplicación está a punto de apagarse, este evento se genera primero, seguido de un ApplicationExit evento.

Se aplica a