Para ver el artículo en inglés, active la casilla Inglés. También puede ver el texto en inglés en una ventana emergente si pasa el puntero del mouse por el texto.
Traducción
Inglés
Esta documentación está archivada y no tiene mantenimiento.

Application (Clase)

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

System.Object
  System.Windows.Forms.Application

Espacio de nombres:  System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

public sealed class Application

El tipo Application expone los siguientes miembros.

  NombreDescripción
Propiedad públicaMiembro estáticoAllowQuitObtiene un valor que indica si el llamador puede cerrar la aplicación.
Propiedad públicaMiembro estáticoCommonAppDataPathObtiene la ruta de acceso de los datos de aplicación compartidos por todos los usuarios.
Propiedad públicaMiembro estáticoCommonAppDataRegistryObtiene la clave del Registro de los datos de aplicación compartidos por todos los usuarios.
Propiedad públicaMiembro estáticoCompanyNameObtiene el nombre de la compañía asociado a la aplicación.
Propiedad públicaMiembro estáticoCurrentCultureObtiene o establece la información de referencia cultural del subproceso actual.
Propiedad públicaMiembro estáticoCurrentInputLanguageObtiene o establece el idioma de entrada actual para el subproceso actual.
Propiedad públicaMiembro estáticoExecutablePathObtiene la ruta de acceso del archivo ejecutable que inició la aplicación, incluido el nombre del archivo ejecutable.
Propiedad públicaMiembro estáticoLocalUserAppDataPathObtiene la ruta de acceso de los datos de aplicación de un usuario local no móvil.
Propiedad públicaMiembro estáticoMessageLoopObtiene un valor que indica si existe un bucle de mensajes en el subproceso.
Propiedad públicaMiembro estáticoOpenFormsObtiene una colección de formularios abiertos que posee la aplicación.
Propiedad públicaMiembro estáticoProductNameObtiene el nombre de producto asociado a la aplicación.
Propiedad públicaMiembro estáticoProductVersionObtiene la versión de producto asociada a la aplicación.
Propiedad públicaMiembro estáticoRenderWithVisualStylesObtiene un valor que especifica si la aplicación actual dibuja los controles con estilos visuales.
Propiedad públicaMiembro estáticoSafeTopLevelCaptionFormatObtiene o establece la cadena de formato que se va a aplicar a los títulos de las ventanas de nivel superior cuando se muestren con un titular de advertencia.
Propiedad públicaMiembro estáticoStartupPathObtiene la ruta de acceso del archivo ejecutable que inició la aplicación, sin incluir el nombre del archivo ejecutable.
Propiedad públicaMiembro estáticoUserAppDataPathObtiene la ruta de acceso de los datos de aplicación de un usuario.
Propiedad públicaMiembro estáticoUserAppDataRegistryObtiene la clave del Registro de los datos de aplicación de un usuario.
Propiedad públicaMiembro estáticoUseWaitCursorObtiene o establece si el cursor de espera se utiliza para todos los formularios abiertos de la aplicación.
Propiedad públicaMiembro estáticoVisualStyleStateObtiene un valor que especifica cómo se van a aplicar los estilos visuales a las ventanas de la aplicación.
Arriba

  NombreDescripción
Método públicoMiembro estáticoAddMessageFilterAgrega un filtro de mensajes que controla los mensajes de Windows conforme se enrutan a sus destinos.
Método públicoMiembro estáticoDoEventsProcesa todos los mensajes de Windows que hay actualmente en la cola de mensajes.
Método públicoMiembro estáticoEnableVisualStylesHabilita los estilos visuales para la aplicación.
Método públicoEquals(Object)Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método públicoMiembro estáticoExit()Notifica a todos los surtidores de mensajes que deben terminar y, a continuación, cierra todas las ventanas de la aplicación una vez procesados todos los mensajes.
Método públicoMiembro estáticoExit(CancelEventArgs)Notifica a todos los surtidores de mensajes que deben terminar y, a continuación, cierra todas las ventanas de la aplicación una vez procesados todos los mensajes.
Método públicoMiembro estáticoExitThreadAbandona el bucle de mensajes del subproceso actual y cierra todas las ventanas del subproceso.
Método públicoMiembro estáticoFilterMessageEjecuta cualquier filtro respecto a un mensaje de ventana y devuelve una copia del mensaje modificado.
Método protegidoFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por el recolector de basura. (Se hereda de Object).
Método públicoGetHashCodeActúa como función hash para un tipo concreto. (Se hereda de Object).
Método públicoGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método protegidoMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoMiembro estáticoOleRequiredInicializa OLE en el subproceso actual.
Método públicoMiembro estáticoOnThreadExceptionProvoca el evento ThreadException.
Método públicoMiembro estáticoRaiseIdleProvoca el evento Idle en escenarios hospedados.
Método públicoMiembro estáticoRegisterMessageLoopRegistra una devolución de llamada para comprobar si el bucle de mensajes se está ejecutando en entornos hospedados.
Método públicoMiembro estáticoRemoveMessageFilterQuita un filtro de mensajes del surtidor de mensajes de la aplicación.
Método públicoMiembro estáticoRestartCierra la aplicación e inicia una nueva instancia inmediatamente.
Método públicoMiembro estáticoRun()Inicia la ejecución de un bucle de mensajes de aplicación estándar en el subproceso actual, sin un formulario.
Método públicoMiembro estáticoRun(ApplicationContext)Inicia la ejecución de un bucle de mensajes de aplicación estándar en el subproceso actual, con un objeto ApplicationContext.
Método públicoMiembro estáticoRun(Form)Inicia la ejecución de un bucle de mensajes de aplicación estándar en el subproceso actual y hace que el formulario especificado esté visible.
Método públicoMiembro estáticoSetCompatibleTextRenderingDefaultEstablece el valor predeterminado de toda la aplicación para la propiedad UseCompatibleTextRendering definida en algunos controles.
Método públicoMiembro estáticoSetSuspendStateSuspende o hiberna el sistema o solicita que el sistema se suspenda o hiberne.
Método públicoMiembro estáticoSetUnhandledExceptionMode(UnhandledExceptionMode)Indica a la aplicación cómo responder a las excepciones no controladas.
Método públicoMiembro estáticoSetUnhandledExceptionMode(UnhandledExceptionMode, Boolean)Indica a la aplicación cómo responder a las excepciones no controladas, aplicando opcionalmente el comportamiento específico del subproceso.
Método públicoToString Devuelve una cadena que representa al objeto actual. (Se hereda de Object).
Método públicoMiembro estáticoUnregisterMessageLoopElimina del Registro la devolución de llamada del bucle de mensajes realizada con RegisterMessageLoop.
Arriba

  NombreDescripción
Evento públicoMiembro estáticoApplicationExitSe produce cuando la aplicación se va a cerrar.
Evento públicoMiembro estáticoEnterThreadModalSe produce cuando la aplicación está a punto de entrar en un estado modal.
Evento públicoMiembro estáticoIdleSe produce cuando la aplicación termina el procesamiento y se dispone a entrar en estado de inactividad.
Evento públicoMiembro estáticoLeaveThreadModalAparece cuando la aplicación está a punto de dejar un estado modal.
Evento públicoMiembro estáticoThreadException Se desencadena cuando se produce una excepción no controlada.
Evento públicoMiembro estáticoThreadExitSe produce cuando se va a cerrar un subproceso. Cuando se va a cerrar el subproceso principal de una aplicación, primero se provoca este evento, seguido de un evento ApplicationExit.
Arriba

La clase Application tiene métodos para iniciar y detener aplicaciones y subprocesos, y para procesar mensajes de Windows, de la manera siguiente.

  • Run inicia un bucle de mensajes de aplicación en el subproceso actual y, si lo desea, para hacer 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 al surtidor de mensajes de la aplicación con el fin de supervisar los mensajes de Windows.

  • IMessageFilter le permite impedir que se provoque un evento o llevar a cabo operaciones especiales antes de invocar un controlador de eventos.

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

No se puede crear una instancia de esta clase,

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

El método Main llama a Run para iniciar la aplicación, con lo que se crean el formulario, listBox1 y button1. Cuando el usuario hace clic en button1, el método button1_Click muestra un objeto MessageBox. Si el usuario hace clic en No en MessageBox, el método button1_Click agrega un número a la lista. Si el usuario hace clic en Yes, la aplicación llama a Exit para procesar todos los mensajes que quedan en la cola y, a continuación, cerrarse.

NotaNota

Se producirá un error en la llamada a Exit si la confianza es parcial.


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


.NET Framework

Compatible con: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.
Mostrar: