Página de aplicación, diseñador de proyectos (Visual Basic)

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

Para acceder a la página Aplicación , elija un nodo de proyecto (no el nodo Solución ) en el Explorador de soluciones. A continuación, elija Propiedades de Projecten la barra de menús. Cuando aparezca el Diseñador de proyectos , seleccione la pestaña Aplicación .

Configuración general de la aplicación

Las siguientes opciones 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, la propiedad Nombre de salida también cambia.

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

Para obtener información sobre cómo acceder 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 nombresProject1 raíz en y tiene fuera Class1 de cualquier espacio de nombres en el código, su espacio de nombres sería Project1.Class1. Si tiene un Class2 en un espacio de nombres Order en el código, su espacio de nombres sería Project1.Order.Class2.

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

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

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

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

Marco de destino (todas las configuraciones)

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

Para los proyectos de .NET Framework, el valor predeterminado coincide con la plataforma de destino que especificó al crear el proyecto.

Para obtener más información, consulte Framework targeting overview.

Tipo de aplicación

Especifica el tipo de aplicación que se va a compilar. Los valores son diferentes en función del 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 control web.

Para un proyecto de aplicación web, debe especificar la 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 acceder a esa propiedad mediante programación, vea OutputType.

Redireccionamientos de enlace de generación automática

Las redirecciones 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 desea definir manualmente los redireccionamientos de enlace en el archivo del proyecto, anule la selección de Redireccionamientos de enlace de generación automática.

Para obtener más información sobre el redireccionamiento, consulte Redireccionamiento de versiones de ensamblado.

Formulario de inicio / Objeto de inicio / URI de inicio

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

Si se selecciona Habilitar marco de aplicación (valor predeterminado), esta lista se denomina Formulario de inicio y solo muestra formularios porque el marco de trabajo de la aplicación solo admite formularios de inicio, no objetos.

Si el proyecto es una aplicación del explorador WPF, esta lista se denomina URI de inicio y el 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 habilita el marco de trabajo de la aplicación se borra, esta lista se convierte en Objeto de inicio y muestra formularios y clases o módulos con un Sub Main.

El objeto de inicio define el punto de entrada al que se va a llamar cuando se carga la aplicación. Por lo general, se establece en el formulario principal de la aplicación o en el Sub Main procedimiento que se debe ejecutar cuando se inicia la aplicación. Dado que las bibliotecas de clases no tienen un punto de entrada, su única opción para esta propiedad es (None). Para obtener más información, vea /main. Para acceder a esta propiedad mediante programación, consulte StartupObject.

Icono

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

Información del ensamblado

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

Habilitación del 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 el objeto Startup form Startup (Inicio del formulario/de inicio).

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

Si esta casilla está desactivada, la aplicación usa la personalizada Sub Main que especificó en el formulario de inicio. En este caso, puede especificar un objeto de inicio (un personalizado Sub Main en un método o una clase) o un formulario. Además, las opciones de la sección propiedades del marco de aplicaciones de Windows no estarán disponibles.

Ver la 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. A continuación, establezca el nivel de ejecución solicitado de UAC modificando la <requestedExecutionLevel> etiqueta en app.manifest de la siguiente manera:

<requestedExecutionLevel level="asInvoker" />

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

Propiedades del marco de trabajo de aplicaciones de Windows

La siguiente configuración está disponible en la sección propiedades del marco de trabajo de aplicaciones de Windows . Estas opciones solo están disponibles si está activada la casilla Habilitar marco de aplicación .

Habilitar estilos visuales de Windows

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

Creación de una aplicación de instancia única

Active esta casilla para impedir que los usuarios ejecuten varias instancias de la aplicación. La configuración predeterminada de esta casilla está desactivada, lo que permite ejecutar varias instancias de la aplicación. Para obtener más información, vea el evento UIElement.Drop.

Guardar My.Settings al apagar

Active esta casilla para especificar que la configuración de la My.Settings aplicación se guarde cuando los usuarios apaguen sus equipos. De forma predeterminada, esta opción 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 al usuario que ha iniciado sesión actualmente. Puede recuperar esta información en tiempo de ejecución mediante el My.User objeto . Seleccione Aplicación definida si proporcionará su propio código para autenticar a los usuarios en lugar de usar los métodos de autenticación predeterminados de Windows.

Modo de apagado

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

Seleccione Activar apagado explícito para especificar que la aplicación salga cuando llame explícitamente a Shutdown.

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

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

Pantalla de inicio

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

Ver eventos de aplicación

Haga clic en este botón para mostrar un archivo de código de eventos en el que puede escribir eventos para los eventos Startupdel marco de trabajo de la aplicación , Shutdown, UnhandledExceptiony StartupNextInstanceNetworkAvailabilityChanged. También puede invalidar determinados métodos del marco de trabajo de la aplicación. Por ejemplo, puede cambiar el comportamiento de visualización de la pantalla de presentación invalidando OnInitialize.

Propiedades del marco de trabajo de aplicaciones de Windows para aplicaciones de Windows Presentation Foundation (WPF)

La siguiente configuración está disponible en la sección propiedades del marco de aplicaciones de Windows cuando el proyecto es una aplicación de Windows Presentation Foundation (WPF). Estas opciones solo están disponibles si está activada la casilla Habilitar marco de aplicación . Las opciones enumeradas en esta tabla solo están disponibles para aplicaciones de explorador WPF o WPF. No están disponibles para las bibliotecas de control de usuario o control personalizado de WPF.

Modo de apagado

Esta propiedad solo es aplicable a las aplicaciones de Windows Presentation Foundation (WPF).

Seleccione Activar apagado explícito para especificar que la aplicación salga cuando llame explícitamente a Shutdown.

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

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

Para obtener más información sobre el uso de esta configuración, consulte Shutdown

Edición de 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, Application.xaml se abre en el nodo de definición de la aplicación. Es posible que tenga que editar este archivo para realizar determinadas tareas, como definir recursos. Si el archivo de definición de aplicación no existe, el Diseñador de proyectos crea uno.

Ver eventos de aplicación

Este botón abre el Application archivo de clase (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 Application objeto genera eventos cuando se producen determinados cambios de estado de aplicación (por ejemplo, en el inicio o apagado de la aplicación). 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 Application clase parcial.