Application Page, Project Designer (Visual Basic)

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

Para obtener acceso a la página Aplicación, seleccione un nodo de proyecto (no el nodo Solución) en el Explorador de soluciones. Después, seleccione Proyecto>Propiedades en la barra de menús. Cuando aparezca el Diseñador de proyectos, seleccione la pestaña Aplicación.

Nota

Es posible que el equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en este artículo. Es posible que esté usando una edición diferente de Visual Studio o una configuración de entorno diferente. Para obtener más información, vea Personalizar el IDE.

Configuración de aplicación general

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

Nombre del ensamblado

Especifica el nombre del archivo de salida que contendrá el manifiesto del ensamblado. Si cambia esta propiedad, también cambia la propiedad Nombre de archivo de salida.

También puede especificar el nombre del archivo de salida desde un símbolo del sistema mediante el modificador de compilador /out (Visual Basic).

Para obtener información sobre cómo tener acceso a esta propiedad mediante programación, vea AssemblyName.

Espacio de nombres raíz

Especifica el espacio de nombres base para todos los archivos del proyecto. Por ejemplo, si establece el espacio de nombres raíz en Project1 y tiene un Class1 fuera de cualquier espacio de nombres en el código, su espacio de nombres será Project1.Class1. Si tiene un Class2 en un espacio de nombres Order en el código, su espacio de nombres será Project1.Order.Class2.

Si desactiva el espacio de nombres raíz, puede especificar la estructura del espacio de nombres del proyecto en el código.

Nota

Si usa la palabra clave Global en una Instrucción de espacio de nombres, puede definir un espacio de nombres fuera del espacio de nombres raíz del proyecto. Si desactiva el espacio de nombres raíz, Global se convierte en el espacio de nombres de nivel superior, lo que elimina la necesidad de la palabra clave Global en una instrucción Namespace. Para obtener más información, vea "Palabra clave Global en las instrucciones de espacio de nombres" en Espacios de nombres en Visual Basic.

Para obtener información sobre cómo crear espacios de nombres en su código, vea Namespace (Instrucción).

Para obtener más información sobre la propiedad de espacio de nombres raíz, vea /rootnamespace.

Para obtener información sobre cómo tener acceso a esta propiedad mediante programación, vea RootNamespace.

Plataforma de destino (todas las configuraciones)

Especifica la versión de .NET a la que se destina la aplicación. Esta opción puede tener valores diferentes según las versiones de .NET instaladas en el equipo.

En los proyectos de .NET Framework, el valor predeterminado coincide con el marco de destino especificado al crear el proyecto.

Nota

Los paquetes de requisitos previos que se muestran en el cuadro de diálogo Requisitos previos se establecen automáticamente la primera vez que abre el cuadro de diálogo. Si posteriormente cambia la plataforma de destino del proyecto, debe especificar manualmente los requisitos previos para que coincidan con la nueva plataforma de destino.

Para obtener más información, vea Información general sobre destinos de Framework.

Tipo de aplicación

Especifica el tipo de aplicación que se va a compilar. Los valores difieren según el tipo de proyecto. Por ejemplo, para un proyecto de Aplicación de Windows Forms, puede especificar Aplicación de Windows Forms, Biblioteca de clases, Aplicación de consola, Servicio de Windows o Biblioteca de controles web.

Para un proyecto de aplicación web, debe especificar Biblioteca de clases.

Para obtener más información sobre la propiedad Tipo de aplicación, vea /target (Visual Basic). Para obtener información sobre cómo tener acceso a esa propiedad mediante programación, vea OutputType.

Generar automáticamente redireccionamientos de enlace

Los redireccionamientos de enlace se agregan al proyecto si la aplicación o sus componentes hacen referencia a más de una versión del mismo ensamblado. Si quiere definir manualmente los redireccionamientos de enlace en el archivo de proyecto, desactive Generar automáticamente redireccionamientos de enlace.

Para obtener más información sobre los redireccionamientos, vea Redirecting assembly versions (Redireccionamiento de versiones de ensamblado).

Formulario de inicio / Objeto de inicio / URI de inicio

Especifica el punto de entrada o el formulario de inicio de la aplicación.

Si Habilitar marco de trabajo de la aplicación está seleccionado (valor predeterminado), esta lista se titula Formulario de inicio y muestra solo formularios, ya que el marco de trabajo de la aplicación admite solo formularios de inicio, no objetos.

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

Si Habilitar marco de trabajo de la aplicación está desactivado, esta lista se convierte en Objeto de inicio y muestra los formularios y las clases o módulos con un Sub Main.

Objeto de inicio define el punto de entrada al que se va a llamar cuando se cargue la aplicación. Normalmente, esto se establece en el formulario principal de la aplicación o en el procedimiento Sub Main que debe ejecutarse cuando se inicia la aplicación. Dado que las bibliotecas de clases no tienen un punto de entrada, la única opción para esta propiedad es (None) . Para obtener más información, vea /main. Para obtener acceso a esta propiedad mediante programación, vea StartupObject.

Icono

Establece el archivo .ico que quiere usar como su icono del programa. Seleccione <Examinar...> para buscar un gráfico existente. Para obtener más información, vea /win32icon (o /win32icon (Opciones del compilador de C#). Para obtener acceso a esta propiedad mediante programación, vea ApplicationIcon.

Información de ensamblado

Haga clic en este botón para mostrar el cuadro de diálogo Información de ensamblado.

Habilitar marco de trabajo de la aplicación

Especifica si un proyecto usará 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 de inicio.

Si esta casilla está seleccionada, la aplicación usará el Sub Main estándar. Al seleccionar esta casilla se habilitan las características de la sección Propiedades del marco de trabajo de la aplicación Windows, y también es necesario seleccionar un formulario de inicio.

Si esta casilla está desactivada, la aplicación usa el Sub Main personalizado que ha especificado en el Formulario de inicio. En este caso, puede especificar un objeto de inicio (un 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 Windows dejarán de estar disponibles.

Ver configuración de Windows

Haga clic en este botón para generar y abrir el archivo app.manifest. Visual Studio usa este archivo para generar datos de manifiesto para la aplicación. Luego, para establecer el nivel de ejecución solicitado de UAC, modifique la etiqueta <requestedExecutionLevel> de app.manifest de la manera siguiente:

<requestedExecutionLevel level="asInvoker" />

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

Propiedades del marco de trabajo de la aplicación Windows

Las siguientes opciones de configuración están disponibles en la sección Propiedades del marco de trabajo de la aplicación Windows. Estas opciones están disponibles solo si la casilla Habilitar marco de trabajo de la aplicación está seleccionada.

Sugerencia

En la sección siguiente a esta se describe la configuración de las propiedades del marco de trabajo de la aplicación Windows específicas de las aplicaciones de Windows Presentation Foundation (WPF).

Habilitación de los estilos visuales de Windows

Habilita o deshabilita los estilos visuales de Windows, también conocidos como Temas de Windows. Los estilos visuales de Windows presentan, por ejemplo, controles con esquinas redondeadas y colores dinámicos. El valor predeterminado está habilitado.

Crear aplicación de instancia única

Seleccione esta casilla para evitar que los usuarios ejecuten varias instancias de la aplicación. De forma predeterminada, la configuración de esta casilla está desactivada, lo que permite que varias instancias de la aplicación se ejecuten. Para obtener más información, vea el evento StartupNextInstance.

Guardar My.Settings al apagar

Seleccione esta casilla para especificar que la configuración My.Settings de la aplicación se guarde cuando los usuarios apaguen sus equipos. La configuración predeterminada está habilitada. Si esta opción está deshabilitada, puede guardar la configuración de la aplicación manualmente llamando a My.Settings.Save.

Modo de autenticación

Seleccione Windows (valor predeterminado) para especificar el uso de la autenticación de Windows para identificar el usuario que ha iniciado sesión en estos momentos. Puede recuperar esta información en tiempo de ejecución con el objeto My.User. Seleccione Definido por la aplicación si proporcionará su propio código para autenticar usuarios en lugar de usar los métodos de autenticación de Windows predeterminados.

Modo de apagado

Seleccione Al cerrar el formulario de inicio (valor predeterminado) para especificar que se salga de la aplicación cuando el formulario establecido como el formulario de inicio se cierre, incluso aunque otros formularios estén abiertos. Seleccione Al cerrar el último formulario para especificar que se salga de la aplicación cuando el último formulario se cierre o cuando se llame a My.Application.Exit o a la instrucción End explícitamente.

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

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

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

Pantalla de presentación

Seleccione el formulario que quiere usar como una pantalla de presentación. Debe haber creado anteriormente una pantalla de presentación con un formulario o una plantilla. El valor predeterminado es (None) .

Ver eventos de aplicaciones

Haga clic en este botón para mostrar un archivo de código de eventos en el que pueda escribir eventos para los eventos de marco de trabajo de la aplicación Startup, Shutdown, UnhandledException, StartupNextInstance y NetworkAvailabilityChanged. También puede invalidar determinados métodos de marco de trabajo de la aplicación. Por ejemplo, puede invalidar OnInitialize para cambiar el comportamiento de la pantalla de presentación.

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

Las siguientes opciones están disponibles en la sección Propiedades del marco de trabajo de la aplicación Windows cuando el proyecto es una aplicación de Windows Presentation Foundation (WPF). Estas opciones están disponibles solo si la casilla Habilitar marco de trabajo de la aplicación está seleccionada. Las opciones enumeradas en esta tabla solo están disponibles para aplicaciones WPF o de explorador WPF. No están disponibles para bibliotecas de control personalizado o de controles de usuario de WPF.

Modo de apagado

Esta propiedad solo se aplica a aplicaciones de Windows Presentation Foundation (WPF).

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

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

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

Para obtener más información sobre el uso de esta opción, vea Shutdown.

Editar XAML

Este botón abre el archivo de definición de aplicación (Application.xaml) en el editor XAML. Al hacer clic en este botón, se abre Application.xaml en el nodo de definición de aplicación. Puede que tenga que editar este archivo para realizar determinadas tareas, como la definición de recursos. Si el archivo de definición de aplicación no existe, el Diseñador de proyectos crea uno.

Ver eventos de aplicaciones

Este botón abre el archivo de clase 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 genera eventos cuando se producen determinados cambios en el estado de la aplicación (por ejemplo, en el inicio de aplicación o en el apagado). Para obtener una lista completa de los eventos que expone esta clase, vea Application. Estos eventos se controlan en la sección de código de usuario de la clase parcial Application.