General, Common Properties, <Projectname> Property Pages Dialog Box
The General property page in the Common Properties folder contains the following properties:
- Assembly Name
- The name of the output file that will hold the assembly manifest. Changing this property will also change the Output File property.
See AssemblyName Property for information on how to programmatically access this property.
- Output Type
- The type of application to build. In a Web Application project, this property can only be set to Class Library.
See OutputType Property for information on how to programmatically access this property.
- Default Namespace
- The namespace for added items, such as classes, that are added via the Add New Item Dialog Box.
See DefaultNamespace Property (Visual Basic and C# Project Object) and RootNamespace Property for information on how to programmatically access this property.
- Startup Object
- The name of the class that contains the Main method that you want called on program startup.
- Application Icon
- Insert an .ico file into the output file.
- Supported Runtimes
- Specifies the version of the common language runtime supported by the application. Unless otherwise specified, the application will run on the version of the runtime that is used to build the application. Modify this property if you want your application to run on any version of the common language runtime.
This property is only available for Windows Application and ASP.NET Web Application projects. For a Windows application, selecting a runtime causes the project system to update the app.config file in your project or to create an app.config file if one does not already exist. At runtime, the name of the app.config file must be filename.ext.config (where filename.ext is the name of the executable that started the application) and the file must be in the same directory as the executable. The project system will create the filename.ext.config file from the app.config file and place it in the bin\target directory.
If you specify more than one runtime version and the Windows application runs on a computer with more than one runtime version installed, the first version specified in the config file that matches an installed runtime that is available on the system will be used. For more information, see Targeting a .NET Framework Version.
For ASP.NET Web Application projects, modifying this property causes the project system to update the web.config file in your project by adding assembly binding (<bindingRedirect> and <assemblyIdentity>) tags in a <dependentAssembly> section. These binding statements ensure that a consistent set of Framework assemblies is used for the application when it is running under an older version of the runtime. The web.config file remains in the project directory and is not renamed.
When deploying the application to an environment with more than one available version of the runtime, you must ensure the application's virtual directory in IIS is scriptmapped to the intended version of ASP.NET. An application may be scriptmapped to an ASP.NET version using the aspnet_regiis.exe command-line tool associated with the desired version. See the aspnet_regiis.exe documentation for more information.
This property is not available programmatically.
- Project File
- The name of the project file for the current project. This is a read-only property while the project is open in Visual Studio.
See FileName Property for information on how to programmatically access this property.
- Project Folder
- The path to the project directory. While the project is open in Visual Studio, this property is read only.
- Output File
- The name of the project's primary output file (also known as the program image). The file that holds the assembly metadata must be the output file of this application. Therefore, Output File is a read-only property that can only be changed by changing the Assembly Name property.
See OutputFileName Property for information on how to programmatically access this property.
Wrapper Assembly for ActiveX/COM Objects Group
- Wrapper Assembly Key File
- The key file to sign COM components referenced by this project. COM components can be referenced via the Add Reference dialog box. Use sn.exe to generate a key file.
- Wrapper Assembly Key Name
- The key container to sign COM components referenced by this project. COM components can be referenced via the Add Reference dialog box. Use sn.exe to generate a key container.
The container does not have to be stored on your local machine; it can be on an external device connected to your computer.
For information on how to access the General property page in the Common Properties folder, see Setting Visual C# Project Properties.
Smart Device Developer Notes
- Output type
- Only valid output types appear and are based on the active platform. For example, Windows Application appears only if the active platform supports Windows Forms. Console Application and Class Library always appear.
- Supported Runtimes
- Not supported.