Aplicación (Página, Diseñador de proyectos) (Visual Basic)

Artículo
10/07/2008

Actualización: noviembre 2007

Utilice la página Aplicación del Diseñador de proyectos para especificar la configuración y las propiedades de la aplicación de un proyecto.

Para tener acceso a la página Aplicación, seleccione un nodo de proyecto en el Explorador de soluciones y, a continuación, haga clic en la opción Propiedades del menú Proyecto. Cuando aparezca el Diseñador de proyectos, haga clic en la ficha Aplicación.

Nota:
Es posible que su equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que tenga y la configuración que esté utilizando determinan estos elementos. Para obtener más información, consulte Valores de configuración de Visual Studio.

Configuración general de la aplicación

Las opciones siguientes le permiten configurar opciones generales para una aplicación.

Nombre del ensamblado
Especifica el nombre del archivo de resultados que contendrá el manifiesto del ensamblado. Si se cambia esta propiedad, también se cambia la propiedad Nombre de archivo de resultados. También puede realizar esta modificación en un símbolo del sistema utilizando /out (Visual Basic). Para obtener información sobre cómo obtener acceso mediante programación a esta propiedad, consulte AssemblyName.
Espacio de nombres de la raíz
Especifica el espacio de nombres base para todos los archivos del proyecto. Por ejemplo, si establece el espacio de nombres de la raíz en Project1 y tiene una Class1 fuera del espacio de nombres en el código, su espacio de nombres será Project1.Class1. Si tiene una Class2 en un espacio de nombres Order en el código, su espacio de nombres será Project1.Order.Class2.

También se puede borrar la propiedad espacio de nombres de la raíz, lo que permite especificar manualmente la estructura del espacio de nombres del proyecto.

Para obtener información acerca de cómo crear espacios de nombres en el código, consulte Namespace (Instrucción).

Para obtener información sobre la propiedad de espacio de nombres raíz, consulte /rootnamespace.

Para obtener información sobre cómo obtener acceso mediante programación a esta propiedad, consulte RootNamespace.
Tipo de aplicación
Especifica el tipo de aplicación que se va a crear. En un proyecto de aplicación web, esta propiedad únicamente se puede establecer en Biblioteca de clases. Para obtener más información, consulte /target. Para obtener información sobre cómo obtener acceso mediante programación a esta propiedad, consulte OutputType.
Icono
Especifica el archivo .ico que se va a utilizar como icono del programa. Seleccione <Examinar...> para buscar un gráfico existente. Para obtener más información, vea /win32icon (o /win32res (Importar un archivo .ico) (Opciones del compilador de C#)). Para tener acceso a esta propiedad mediante programación, vea ApplicationIcon.
Formulario de inicio / Objeto inicial / URI de inicio
Especifica el formulario de inicio de la aplicación o punto de entrada.

Si se ha seleccionado Habilitar marco de trabajo de la aplicación (el valor predeterminado), esta lista se titula Formulario de inicio y muestra únicamente formularios, porque el marco de trabajo de la aplicación solamente admite formularios de inicio, no objetos.

Si el proyecto es una aplicación de explorador de WPF, esta lista se titula URI de inicio y su valor predeterminado es Page1.xaml. La lista URI de inicio permite especificar el recurso de interfaz de usuario (un elemento XAML) que la aplicación muestra cuando se inicia la aplicación. Para obtener más información, consulte StartupUri.

Si se desactiva Habilitar marco de trabajo de la aplicación, esta lista pasa a ser Objeto inicial y muestra tanto formularios y clases como módulos con un procedimiento Sub Main.

Objeto inicial define el punto de entrada al que se llamará cuando se cargue la aplicación. En general, esto se establece en el formulario principal de la aplicación o en el procedimiento Sub Main que se debe ejecutar cuando se inicia la aplicación. Dado que las bibliotecas de clases no tienen punto de entrada, la única opción para esta propiedad es (Ninguno). Para obtener más información, vea /main. Para tener acceso a esta propiedad mediante programación, vea StartupObject.
Información de ensamblado
Haga clic en este botón para mostrar Información de ensamblado (Cuadro de diálogo).
Habilitar marco de trabajo de la aplicación
Especifica si un proyecto utilizará el marco de trabajo de la aplicación. La configuración de esta opción afecta a las opciones disponibles en Formulario de inicio/Objeto inicial.

Si esta casilla está activada, la aplicación utiliza el procedimiento Sub Main estándar. Al activar esta casilla, se habilitan las características de la sección Propiedades del marco de trabajo de la aplicación para Windows y, además, deberá seleccionar un formulario de inicio.

Si se desactiva esta casilla, la aplicación utiliza el procedimiento Sub Main personalizado especificado en Formulario de inicio. En este caso, puede especificar un objeto inicial (un procedimiento Sub Main personalizado en un método o una clase) o un formulario. Además, las opciones de la sección Propiedades del marco de trabajo de la aplicación para Windows dejan de estar disponibles.
Ver configuración de UAC
Haga clic en este botón para generar y abrir el archivo app.manifest. Visual Studio utiliza este archivo para generar los datos de manifiestos para la aplicación. A continuación, establezca el nivel de ejecución solicitado de UAC modificando la etiqueta <requestedExecutionLevel> en app.manifest, como se muestra a continuación:

<requestedExecutionLevel level="asInvoker" />

ClickOnce trabaja con un nivel de asInvoker o en modo virtualizado (sin generación de manifiestos). Para especificar el modo virtualizado, quite la etiqueta completa de app.manifest.

Para obtener más información sobre la generación de manifiestos, consulte Implementación de ClickOnce en Windows Vista.

Propiedades del marco de trabajo de la aplicación para Windows

La configuración siguiente está disponible en la sección Propiedades del marco de trabajo de la aplicación para Windows. Estas opciones solamente están disponibles si la casilla Habilitar marco de trabajo de la aplicación está activada. La sección que aparece a continuación de ésta describe los valores de configuración de Propiedades del marco de trabajo de la aplicación para Windows para aplicaciones de Windows Presentation Foundation (WPF).

Habilitar estilos visuales de XP
Habilita o deshabilita los estilos visuales de Windows XP, también conocidos como temas de Windows XP. Por ejemplo, los estilos visuales de Windows XP permiten controles con esquinas redondeadas y colores dinámicos. El valor predeterminado está habilitado. Para obtener más información acerca de cómo usar esta configuración, consulte Cómo: Habilitar estilos visuales (Visual Basic). Para obtener más información sobre los estilos visuales de Windows XP, consulte Características de Windows XP y controles de formularios Windows Forms y Cómo: Habilitar estilos visuales en Windows XP.
Convertir aplicación de instancia única
Active esta casilla para evitar que los usuarios ejecuten varias instancias de la aplicación. La configuración predeterminada de esta casilla es desactivada. Este valor permite ejecutar varias instancias de la aplicación. Para obtener más información, vea Cómo: Especificar el comportamiento de las instancias para una aplicación (Visual Basic).
Guardar My.Settings al cerrar
Active esta casilla para especificar que la configuración My.Settings de la aplicación se guarde cuando los usuarios apaguen el equipo. La configuración predeterminada está habilitada. Si se deshabilita esta opción, puede guardar manualmente la configuración de la aplicación llamando a My.Settings.Save.
Modo de autenticación
Seleccione Windows (el valor predeterminado) para especificar el uso de la autenticación de Windows para identificar al usuario actualmente registrado. Puede recuperar esta información en tiempo de ejecución mediante el objeto My.User. Seleccione Definido para la aplicación si va a proporcionar su propio código con el fin de autenticar a los usuarios en lugar de utilizar los métodos de autenticación predeterminados de Windows. Para obtener más información acerca de cómo usar esta configuración, consulte Cómo: Habilitar la autenticación de usuario personalizada (Visual Basic).
Modo de apagado
Seleccione Al cerrar el formulario de inicio (el valor predeterminado) para especificar que se salga de la aplicación cuando se cierre formulario de inicio, aunque haya otros formularios abiertos. Seleccione Al cerrar el último formulario para especificar que se salga de la aplicación cuando se cierra el último formulario o cuando se llame explícitamente a la instrucción My.Application.Exit o End.

Seleccione Al apagar explícitamente para especificar que se salga de la aplicación cuando se llame explícitamente a Shutdown.

Seleccione Al cerrar la última ventana para especificar que se salga de la aplicación cuando se cierre la última ventana o cuando se llame explícitamente a Shutdown. Ésta es la configuración predeterminada.

Seleccione Al cerrar la ventana principal para especificar que se salga de la aplicación cuando se cierre la ventana principal o cuando se llame explícitamente a Shutdown.

Para obtener más información acerca de cómo usar esta configuración, consulte Cómo: Especificar el comportamiento de cierre de una aplicación (Visual Basic).
Pantalla de bienvenida
Seleccione el formulario que desee utilizar como pantalla de bienvenida. Debe haber creado previamente una pantalla de presentación mediante un formulario o una plantilla, de la forma descrita en Cómo: Especificar una pantalla de presentación para una aplicación (Visual Basic). El valor predeterminado es (Ninguno).
Ver eventos de aplicaciones
Haga clic en este botón para mostrar un archivo de código de eventos en el que puede escribir eventos para los eventos del marco de trabajo de la aplicación (Startup, Shutdown, UnhandledException, StartupNextInstance y NetworkAvailabilityChanged). También puede invalidar algunos métodos del marco de trabajo de la aplicación. Por ejemplo, puede cambiar el comportamiento de la presentación de la pantalla de presentación invalidando OnInitialize.

Propiedades del marco de trabajo de la aplicación para Windows para aplicaciones de Windows Presentation Foundation (WPF)

La configuración siguiente está disponible en la sección Propiedades del marco de trabajo de la aplicación para Windows cuando el proyecto es una aplicación de Windows Presentation Foundation. Estas opciones solamente están disponibles si la casilla Habilitar marco de trabajo de la aplicación está activada. Las opciones enumeradas en esta tabla sólo están disponibles para aplicaciones WPF o aplicaciones de explorador WPF. No están disponibles para bibliotecas de controles de usuario o de controles personalizados de WPF.

Modo de apagado
Esta propiedad sólo se puede utilizar con aplicaciones de Windows Presentation Foundation.

Seleccione Al apagar explícitamente para especificar que se salga de la aplicación cuando se llame explícitamente a Shutdown.

Seleccione Al cerrar la última ventana para especificar que se salga de la aplicación cuando se cierre la última ventana o cuando se llame explícitamente a Shutdown. Ésta es la configuración predeterminada.

Seleccione Al cerrar la ventana principal para especificar que se salga de la aplicación cuando se cierre la ventana principal o cuando se llame explícitamente a Shutdown.

Para obtener más información acerca de cómo usar esta configuración, consulte Shutdown o Cómo: Especificar el comportamiento de cierre de una aplicación (Visual Basic).
Editar XAML
Haga clic en este botón para abrir y modificar el archivo de definición de aplicación (Application.xaml) en el editor de XAML. Al hacer clic en este botón, Application.xaml se abre en el nodo de definición de aplicación. Puede que tenga que editar este archivo para realizar ciertas tareas, como definir los recursos. Si el archivo de definición de aplicación no existe, el Diseñador de proyectos crea uno.
Ver eventos de aplicaciones
Haga clic en este botón para mostrar el archivo de clase parcial Application (Application.xaml.vb) en un editor de código. Si el archivo no existe, el Diseñador de proyectos crea uno con el nombre de clase y el espacio de nombres adecuados.

El objeto Application provoca eventos cuando se producen determinados cambios en el estado de la aplicación (por ejemplo, al iniciarse o cerrarse la aplicación). Para obtener una lista completa de los eventos que esta clase expone, consulte Application. Estos eventos se administran en la sección de código de usuario de la clase parcial Application.