Diseñador de proyectos de .NET
Use el del Diseñador de proyectos de
Para acceder al Diseñador de proyectos, elija un nodo de proyecto (no el nodo solución de
Nota
El equipo puede mostrar nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio de 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, consulte Personalizar el IDE.
Aplicación, configuración general
Las siguientes opciones le permiten configurar opciones generales para la aplicación.
tipo de salida
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 consola de, puede especificar aplicación de Windows, aplicación de consolao biblioteca de clases como tipo de salida.
Para obtener más información sobre la propiedad tipo de salida de
Para obtener información sobre cómo acceder a esta propiedad mediante programación, vea OutputType.
de la plataforma de destino de
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.
En el caso de un proyecto destinado a .NET Core o .NET 5+, las versiones disponibles pueden aparecer de la siguiente manera:
Nota
En el caso de las aplicaciones ClickOnce, los paquetes de requisitos previos enumerados en el cuadro de diálogo Requisitos previos de cuadro de diálogo se establecen automáticamente la primera vez que se abre el cuadro de diálogo. Si posteriormente cambia la plataforma de destino del proyecto, debe seleccionar los requisitos previos manualmente para que coincidan con la nueva plataforma de destino.
Para obtener más información, consulte Framework targeting overview.
del sistema operativo de destino
Especifica el sistema operativo al que se dirige el proyecto. En combinación con la plataforma de destino, esto genera una TF específica del sistema operativo de .NET 5+.
del objeto Startup de
Define el punto de entrada al que se va a llamar cuando se carga la aplicación. Por lo general, esto se establece en el formulario principal de la aplicación o en el procedimiento Main 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 (no establecido).
De forma predeterminada, en un proyecto de aplicación de WPF, esta opción se establece en (no establecido). La otra opción es [projectname].App. En un proyecto de WPF, debe establecer el URI de inicio para cargar un recurso de interfaz de usuario cuando se inicie la aplicación. Para ello, abra el archivo Application.xaml en el proyecto y establezca la propiedad StartupUri en un archivo .xaml en el proyecto, como Window1.xaml. Para obtener una lista de los elementos raíz aceptables, consulte StartupUri. También debe definir un método public static void Main() en una clase del proyecto. Esta clase aparecerá en la lista objeto Startup como ProjectName.ClassName. A continuación, puede seleccionar la clase como el objeto de inicio.
Consulte /main (Opciones del compilador de C#) para obtener más información. Para acceder a esta propiedad mediante programación, consulte StartupObject.
nombre del ensamblado de
Especifica el nombre del archivo de salida que contendrá el manifiesto del ensamblado. Al cambiar esta propiedad también se cambia la propiedad Nombre de salida.
También puede realizar este cambio desde la línea de comandos mediante /out (Opciones del compilador de C#).
Para acceder a esta propiedad mediante programación, consulte AssemblyName.
espacio de nombres predeterminado
Especifica el espacio de nombres base para los archivos agregados al proyecto.
Consulte espacio de nombres para obtener más información sobre cómo crear espacios de nombres en el código.
Para acceder a esta propiedad mediante programación, consulte RootNamespace.
Configuración de la aplicación, recursos win32
icono de
Establece el archivo .ico que desea usar como icono de programa. Haga clic en Examinar para buscar un gráfico existente o escriba el nombre del archivo que desee. Consulte /win32icon (Opciones del compilador de C#) para obtener más información.
Para acceder a esta propiedad mediante programación, consulte ApplicationIcon.
Para obtener información sobre cómo crear un icono, vea Editor de imágenes para iconos.
recursos de
La opción Recursos de
Si selecciona archivo de recursos, configure un archivo de recursos para el proyecto. Escriba un nombre de ruta de acceso o use el botón Examinar
de manifiesto de
Selecciona una opción de generación de manifiestos cuando la aplicación se ejecuta en Windows en Control de cuentas de usuario (UAC). Esta opción puede tener los siguientes valores:
Insertar manifiesto con la configuración predeterminada. Admite la manera típica en la que Visual Studio funciona en Windows, que consiste en insertar información de seguridad en el archivo ejecutable de la aplicación, especificando que
requestedExecutionLevelserAsInvoker. Esta es la opción predeterminada.Crear aplicación sin un manifiesto. Este método se conoce como virtualización. Use esta opción para la compatibilidad con aplicaciones anteriores.
Usar un manifiesto personalizado. Permite escribir una ruta de acceso o examinar un manifiesto personalizado para el proyecto.
Configuración de usos globales
usos globales implícitos
Habilita o deshabilita global mediante, que permiten usar tipos definidos en un espacio de nombres sin especificar el espacio de nombres completo.
administrar usos globales implícitos
Agregue y elimine manualmente los usos globales para usarlos en los proyectos.
Compilación, configuración general
símbolos de compilación condicional
Especifica los símbolos en los que se va a realizar la compilación condicional. Separe los símbolos con un punto y coma (";"). Para obtener más información, vea /define (Opciones del compilador de C#).
depurar símbolos personalizados
Especifica símbolos para la compilación condicional para compilaciones de depuración. Los símbolos de depuración predeterminados se muestran en una cadena, separadas por punto y coma.
liberar símbolos personalizados
Especifica símbolos para la compilación condicional para las compilaciones de versión. Los símbolos de versión predeterminados se muestran en una cadena, separadas por punto y coma.
de destino de la plataforma de
Especifica el procesador al que va dirigido el archivo de salida. Elija x86 para cualquier procesador compatible con Intel de 32 bits, elija x64 para cualquier procesador compatible con Intel de 64 bits, elija ARM para procesadores ARM o elija Cualquier CPU para especificar que cualquier procesador sea aceptable. cualquier de CPU es el valor predeterminado para los proyectos, ya que permite que la aplicación se ejecute en la gama más amplia de hardware.
Para obtener más información, vea /platform (Opciones del compilador de C#).
que aceptan valores NULL
Especifica el contexto que acepta valores NULL de C# en todo el proyecto. Esta opción de interfaz de usuario se introdujo en Visual Studio 16.5 y solo está habilitada para proyectos que usan C# 8.0 o posterior.
Para obtener más información, vea contextos que aceptan valores NULL.
Generar información de ensamblado
Especifica si las propiedades del proyecto relacionadas con el paquete se transforman en atributos de ensamblado. Para obtener más información, consulte la propiedad
código no seguro
Permite que el código que usa la palabra clave no segura
Optimizar código
Habilite o deshabilite las optimizaciones realizadas por el compilador para que el archivo de salida sea más pequeño, más rápido y eficaz. Para obtener más información, vea /optimize (Opciones del compilador de C#).
de símbolos de depuración
Especifica el tipo de información de depuración generada por el compilador. Para obtener información sobre cómo configurar el rendimiento de depuración de una aplicación, consulte opción del compilador DebugType. Esta configuración tiene las siguientes opciones:
ninguno
Especifica que no se generará información de depuración.
completa
Habilita la asociación de un depurador al programa en ejecución.
pdbonly
Permite la depuración de código fuente cuando se inicia el programa en el depurador, pero solo mostrará el ensamblador cuando el programa en ejecución esté asociado al depurador.
portátiles
Genera un objeto . Archivo PDB, un archivo de símbolos portátil no específico de la plataforma que proporciona otras herramientas, especialmente depuradores, información sobre lo que se encuentra en el archivo ejecutable principal y cómo se produjo. Consulte PDB portable para obtener más información.
incrustado
Inserta información de símbolos portátiles en el ensamblado. No hay ningún externo. Se genera el archivo PDB.
Para obtener más información, vea /debug (Opciones del compilador de C#).
Configuración de compilación, errores y advertencias
Los valores siguientes se usan para configurar las opciones de error y advertencia para el proceso de compilación.
de nivel de advertencia de
Especifica el nivel que se va a mostrar para las advertencias del compilador. Para obtener más información, vea /warn (Opciones del compilador de C#).
Suprimir advertencias específicas
Bloquea la capacidad del compilador para generar una o varias advertencias específicas. Separe varios números de advertencia con una coma o punto y coma. Para obtener más información, vea /nowarn (Opciones del compilador de C#).
Tratar advertencias como errores
Seleccione si las advertencias se tratan como errores durante el proceso de compilación. Para obtener más información, vea /warnaserror (Opciones del compilador de C#).
Tratar advertencias específicas como errores
Especifique qué advertencias se tratan como errores. Separe varios números de advertencia con una coma o punto y coma.
Propina
Si no desea que las advertencias de análisis de código se traten como errores, consulte Preguntas más frecuentes sobre el análisis de código.
Compilación, configuración de salida
Los valores siguientes se usan para configurar las opciones de salida para el proceso de compilación.
ruta de acceso de salida base
Especifica la ubicación de los archivos de salida para la configuración de este proyecto. Escriba la ruta de acceso de la salida de compilación en este cuadro o elija el botón Examinar
Con configuraciones de compilación simplificadas, el sistema de proyecto determina si se va a compilar una versión de depuración o versión. El comando
de ensamblado de referencia
Especifica si se va a generar un ensamblado de referencia de que contiene la API pública del proyecto.
del archivo de documentación de
Especifica el nombre de un archivo en el que se procesarán los comentarios de documentación. Para obtener más información, vea /doc (Opciones del compilador de C#).
Configuración de compilación, eventos
Para obtener información sobre la configuración del evento de compilación, vea Especificar eventos de compilación (C#).
Compilación, Configuración de publicación
de publicación
Permite que se ejecute el destino de publicación de MSBuild. Para obtener más información, consulte la propiedad
Publicación recortada
Especifica si el recorte está habilitado durante el proceso de publicación. Para obtener más información, consulte propiedades relacionadas con trim.
publicar de AOT nativo
Especifica si se va a generar una aplicación autocontenida y que se ha compilado con antelación (AOT) en código nativo. Para obtener más información, consulte implementación nativa de AOT.
Compilación, configuración de nomenclatura segura
Firmar el ensamblado
Active esta casilla para firmar el ensamblado y crear un archivo de clave con nombre seguro. Para obtener más información sobre cómo firmar el ensamblado mediante el diseñador de proyectos de , vea Cómo: Firmar un ensamblado (Visual Studio). Para obtener más información, consulte ensamblados con nombre seguro.
Esta opción usa la herramienta Al.exe proporcionada por el Kit de desarrollo de software (SDK) de Windows para firmar el ensamblado. Para obtener más información sobre Al.exe, vea Cómo: Firmar un ensamblado con un nombre seguro.
lista de archivo de clave de nombre seguro
Permite especificar un archivo de clave nuevo o existente con nombre seguro que se usa para firmar el ensamblado. Seleccione <Examinar...> para seleccionar un archivo de clave existente.
signo delay solo
Active esta casilla para habilitar la firma retrasada. Para obtener más información, vea Delay-sign an assembly.
Tenga en cuenta que un proyecto firmado retrasado no se ejecutará y no se podrá depurar. Sin embargo, puede usar el de
Nota
Al firmar un ensamblado, es posible que no siempre tenga acceso a una clave privada. Por ejemplo, una organización podría tener un par de claves estrechamente protegido a los que los desarrolladores no tienen acceso a diario. La clave pública puede estar disponible, pero el acceso a la clave privada está restringido a algunas personas. En tal caso, puede usar retrasada o firma parcial para proporcionar la clave pública, aplazar la adición de la clave privada hasta que se entregue el ensamblado.
Compilación, configuración avanzada
Las siguientes opciones le permiten establecer la configuración de compilación avanzada.
versión de
Vínculos a /langversion (opciones del compilador de C#), que proporciona información sobre cómo se elige una versión de lenguaje predeterminada en función de la plataforma de destino de un proyecto.
Comprobación de de desbordamiento aritmético
Especifica si una instrucción aritmética de enteros que no está en el ámbito del comprobado o palabras clave de desactivadas y que da como resultado un valor fuera del intervalo del tipo de datos provocará una excepción en tiempo de ejecución. Para obtener más información, vea /checked (Opciones del compilador de C#).
determinista
Especifica si se va a generar una salida equivalente de byte-for-byte desde el mismo origen de entrada. Para obtener más información, vea Opciones del compilador de C# que controlan la generación de código.
informe de errores internos del compilador
Especifica si se deben notificar errores del compilador a Microsoft. Si se establece en solicitud (valor predeterminado), recibirá un mensaje si se produce un error interno del compilador, lo que le ofrece la opción de enviar un informe de errores electrónicamente a Microsoft. Si se establece en enviar, se enviará automáticamente un informe de errores. Si se establece en cola, se ponen en cola los informes de errores. Si se establece en ninguno, el error solo se notificará en la salida de texto del compilador. Para obtener más información, vea /errorreport (Opciones del compilador de C#).
de alineación de archivos de
Especifica el tamaño de las secciones del archivo de salida. Los valores válidos son 512, 1024, 2048, 4096y 8192. Estos valores se miden en bytes. Cada sección se alineará en un límite que sea un múltiplo de este valor, lo que afecta al tamaño del archivo de salida. Para obtener más información, vea /filealign (Opciones del compilador de C#).
Paquete, configuración general
Las propiedades de esta sección se usan para configurar paquetes, normalmente correspondientes a las propiedades de un archivo de .nuspec de NuGet
Paquete, configuración de licencia
de licencia de paquete de
Especifica si se debe incluir una expresión de licencia o un archivo de licencia en el paquete. Para obtener más información, consulte el elemento licencia de
Paquete, configuración de símbolos
Generar un paquete de símbolos
Especifica si se va a crear un paquete de símbolos para la depuración. Para obtener más información, vea Crear paquetes de símbolos (.snupkg).
Análisis de código, toda la configuración del analizador
Ejecutar en de compilación
Especifica si se va a ejecutar el análisis de código fuente al compilar el proyecto. Para obtener más información, vea Deshabilitar el análisis de código fuente para .NET.
Ejecutar en de análisis en directo
Especifica si se va a ejecutar el análisis de código fuente activo al compilar el proyecto. Para obtener más información, vea Deshabilitar el análisis de código fuente para .NET.
Análisis de código, configuración del analizador de .NET
Aplicar estilo de código en la compilación
Especifica si se notifican infracciones de estilo de código de .NET al compilar el proyecto. Para obtener más información, consulte Aplicar estilos de código en la compilación.
Habilitar analizadores de .NET
Habilita o deshabilita los analizadores de la plataforma del compilador de .NET (Roslyn). Para obtener más información, vea Habilitar o instalar analizadores de .NET de terceros.
de nivel de análisis de
Especifica el conjunto de analizadores que se van a ejecutar en el proyecto. Para obtener más información, consulte sección Actualizaciones más recientes en el artículo introducción al análisis de código.
Depuración, configuración general
Seleccione el vínculo para abrir la interfaz de usuario de perfiles de inicio de depuración. Esta interfaz de usuario permite agregar y configurar diferentes perfiles que se usarán al depurar. Cada nombre de perfil aparece como una opción de inicio en la lista iniciar depuración
Para los proyectos de ASP.NET Core, la configuración de la interfaz de usuario de perfiles de inicio corresponde a la configuración del archivo launchSettings.json del proyecto. Para obtener información detallada sobre cómo se usa este archivo en ASP.NET desarrollo, consulte Development and launchSettings.json.
Recursos, configuración general
Seleccione el vínculo para abrir el archivo de recursos de ensamblado RESX. Para obtener más información, vea página Configuración, Diseñador de proyectos.