Udostępnij za pośrednictwem


Properties for the File System Editor

The following properties are available when working in the File System Editor. The actual properties available at any given time are dependent on the project type and the current selection in the editor.

Property Types

Type

Description

Folder Properties

Properties that may be available in the Properties window when a folder is selected in the File System editor for a Setup or Merge Module project.

Web Application Folder Properties

Properties that may be available in the Properties window when a folder is selected in the File System editor for a Web Setup project.

File Properties

Properties that may be available in the Properties window when a file is selected in the File System editor.

Assembly Properties

Properties that may be available in the Properties window when an assembly is selected in the File System editor.

Project Output Group Properties

Properties that may be available in the Properties window when a project output group is selected in the File System editor.

Shortcut Properties

Properties that may be available in the Properties window when a shortcut is selected in the File System editor.

Folder Properties

Property

Description

AlwaysCreate

Specifies whether to create the selected folder as part of every installation, even if the folder is empty. For more information, see AlwaysCreate Property.

Condition

Specifies a Windows Installer condition that must be satisfied (evaluate to true) in order for the selected item to be installed at installation time.

DefaultLocation

Specifies the default location where a folder will be installed on the target computer. For more information about special folders, see Special Folders and Custom Folders.

Description

Stores a description of a module retargetable folder.

DisplayName

Specifies a name for a module retargetable folder that can be used in the run-time user interface.

Name

Specifies the name of the selected folder. Read-only for special folders.

Property

Specifies a named property that can be accessed at installation time to override the path of a custom folder. For more information, see Property Property (Folders).

Transitive

Determines whether the installer will reevaluate the Condition property for the selected item when installing or reinstalling on a target computer. For more information, see Transitive Property.

Web Application Folder Properties

Property

Description

AllowDirectoryBrowsing

Sets the Internet Information Services Directory browsing property for the selected folder. For more information, see AllowDirectoryBrowsing Property.

AllowReadAccess

Sets the Internet Information Services Read property for the selected folder. For more information, see AllowReadAccess Property.

AllowScriptSourceAccess

Sets the Internet Information Services Script source access property for the selected folder. For more information, see AllowScriptSourceAccess Property.

AllowWriteAccess

Sets the Internet Information Services Write property for the selected folder. For more information, see AllowWriteAccess Property.

AlwaysCreate

Specifies whether to create the selected folder as part of every installation, even if the folder is empty. For more information, see AlwaysCreate Property.

ApplicationProtection

Sets the Internet Information Services Application Protection property for the selected folder. For more information, see ApplicationProtection Property.

AppMappings

Sets the Internet Information Services Application Mappings property for the selected folder. For more information, see AppMappings Property.

Condition

Specifies a Windows Installer condition that must be satisfied (evaluate to true) in order for the selected item to be installed at installation time.

DefaultDocument

Specifies the default (startup) document for the selected folder.

ExecutePermissions

Sets the Internet Information Services Execute Permissions property for the selected folder. For more information, see ExecutePermissions Property.

Index

Sets the Internet Information Services Index this resource property for the selected folder. For more information, see Index Property (Windows Installer).

IsApplication

Specifies whether an Internet Information Services application root will be created for the selected folder.

LogVisits

Sets the Internet Information Services Log Visits property for the selected folder. For more information, see LogVisits Property.

Name

Specifies the name of the selected folder. Read-only for special folders.

Property

Specifies a named property that can be accessed at installation time to override the path of a custom folder. For more information, see Property Property (Folders).

Transitive

Determines whether the installer will reevaluate the Condition property for the selected item when installing or reinstalling on a target computer. For more information, see Transitive Property.

VirtualDirectory

Specifies a directory relative to a Web server where a Web application folder will be installed on a target computer. For more information, see VirtualDirectory Property.

File Properties

Property

Description

Condition

Specifies a Windows Installer condition that must be satisfied (evaluate to true) in order for the selected item to be installed at installation time.

Exclude

Determines whether a file will be excluded from an installer or merge module. For more information, see Exclude Property.

Folder

Specifies the folder where the selected file will be installed on the target computer. For more information, see Folder Property.

Hidden

Specifies whether to install a file as a hidden file. By default, hidden files do not appear in the user's directory listings.

PackageAs

Specifies whether to override the default packaging behavior for a selected file. For more information, see PackageAs Property.

Permanent

Specifies whether a file should be removed when the application is uninstalled. For more information, see Permanent Property.

ReadOnly

Specifies whether to install a selected file as a read-only file. Users cannot edit or delete read-only files.

Register

Specifies whether a file should be registered during installation. For more information, see Register Property.

SharedLegacy

Specifies whether to mark a selected file as a shared legacy file that requires reference counting. For more information, see SharedLegacy Property.

SourcePath

Displays the path to a selected file on the development computer. Read-only.

System

Specifies whether to install a selected file as a system file. A system file is normally a binary file that is part of the operating system.

TargetName

Specifies a name for a file when it is installed on a target computer. The file is renamed during installation if it differs from the source file name.

Transitive

Determines whether the installer will reevaluate the Condition property for the selected item when installing or reinstalling on a target computer. For more information, see Transitive Property.

Vital

Specifies whether a selected file is vital for installation. If a vital file cannot be installed correctly, the entire installation will fail.

Assembly Properties

Property

Description

Condition

Specifies a Windows Installer condition that must be satisfied (evaluate to true) in order for the selected item to be installed at installation time.

Dependencies

Displays the Dependencies dialog box that contains a list of dependent files. Read-only.

DisplayName

Indicates the name for an assembly that can be used in the run-time user interface to identify the assembly. Read-only.

Exclude

Determines whether an assembly will be excluded from an installer or merge module. For more information, see Exclude Property.

Files

Displays the Files dialog box that contains a list of files in the assembly. Read-only.

Folder

Specifies the folder where the selected assembly will be installed on the target computer. For more information, see Folder Property.

HashAlgorithm

Indicates the hash algorithm used by the assembly manifest. Read-only.

Hidden

Specifies whether to install an assembly as a hidden file. By default, hidden files do not appear in the user's directory listings.

Language

Indicates the language for a localized assembly. Read-only.

Originator

Indicates the public part of the originator of the key pair for the assembly. Read-only.

PackageAs

Specifies whether to override the default packaging behavior for a selected assembly. For more information, see PackageAs Property.

Permanent

Specifies whether an assembly should be removed when the application is uninstalled. For more information, see Permanent Property.

PublicKey

Indicates the cryptographic public key for the assembly. Read-only.

ReadOnly

Specifies whether to install a selected assembly as a read-only file. Users cannot edit or delete read-only files.

Register

Specifies whether a selected assembly should be registered during installation. For more information, see Register Property.

SharedLegacy

Specifies whether to mark a selected assembly as a shared legacy file that requires reference counting. For more information, see SharedLegacy Property.

SourcePath

Indicates the path to a selected assembly on the development computer. Read-only.

System

Specifies whether to install a selected assembly as a system file. A system file is normally a binary file that is part of the operating system.

TargetName

Indicates the name for an assembly when it is installed on a target computer. Read-only.

Transitive

Determines whether the installer will reevaluate the Condition property for the selected item when installing or reinstalling on a target computer. For more information, see Transitive Property.

Version

Indicates the version number of an assembly. Read-only.

Vital

Specifies whether a selected assembly is vital for installation. If a vital assembly cannot be installed correctly, the entire installation will fail.

Project Output Group Properties

Property

Description

Condition

Specifies a Windows Installer condition that must be satisfied (evaluate to true) in order for the selected item to be installed at installation time.

Dependencies

Displays the Dependencies dialog box that contains a list of dependent files. Read-only.

Exclude

Determines whether a project output group will be excluded from an installer or merge module. For more information, see Exclude Property.

ExcludeFilter

Displays the Filter dialog box that allows you to exclude files using wild cards.

Folder

Specifies the folder where the selected files will be installed on the target computer. For more information, see Folder Property.

HashAlgorithm

Indicates the hash algorithm used by the assembly manifest. Read-only.

Hidden

Specifies whether to install the files in a project output group as hidden files. By default, hidden files do not display in the user's directory listings.

Originator

Indicates the public part of the originator of the key pair for the key output in the project output group. Read-only.

Outputs

Displays the Outputs dialog box that contains a list of files in the primary output group. Read-only.

PackageAs

Specifies whether to override the default packaging behavior for a selected project output group. For more information, see PackageAs Property.

Permanent

Specifies whether files in a project output group should be removed when the application is uninstalled. For more information, see Permanent Property.

PublicKey

Indicates the cryptographic public key for the key output in the project output group. Read-only.

ReadOnly

Specifies whether to install the files in a selected project output group as read-only files. Users cannot edit or delete read-only files.

Register

Specifies whether files in project output group should be registered during installation. For more information, see Register Property.

SharedLegacy

Specifies whether to mark files in a selected project output group as shared legacy files that require reference counting. For more information, see SharedLegacy Property.

SourcePath

Indicates the path to the key output in the project output group on the development computer. Read-only.

System

Specifies whether to install files in a selected project output group as system files. A system file is normally a binary file that is part of the operating system.

TargetName

Indicates the name for the key output in the project output group when it is installed on a target computer. Read-only.

Transitive

Determines whether the installer will reevaluate the Condition property for the selected item when installing or reinstalling on a target computer. For more information, see Transitive Property.

Version

Indicates the version number of the key output in the project output group. Read-only.

Vital

Specifies whether a selected project output group is vital for installation. If a vital file cannot be installed correctly, the entire installation will fail.

Shortcut Properties

Property

Description

Arguments

Specifies the command-line arguments for the shortcut. For more information, see Arguments Property (Windows Installer).

Description

Specifies the description that will appear in the Tooltip for the shortcut.

Folder

Specifies the folder where the selected shortcut will be installed on the target computer. For more information, see Folder Property.

Icon

Specifies an icon to be displayed for the shortcut. For more information, see Icon Property.

Name

Specifies the name of the shortcut as it will appear when installed on a target computer.

ShowCmd

Specifies the initial window state for an application called by the shortcut. For more information, see ShowCmd Property.

Target

Specifies the application to be launched by a shortcut. For more information, see Target Property.

Transitive

Determines whether the installer will reevaluate the Condition property for the selected item when installing or reinstalling on a target computer. For more information, see Transitive Property.

WorkingFolder

Specifies the folder where the target application for the shortcut will be installed. For more information, see WorkingFolder Property.

See Also

Reference

Deployment Properties

Concepts

Special Folders and Custom Folders

Visual Studio Installer Deployment

Other Resources

Windows Property Reference

Deployment Editors

Launch Condition Management in Deployment