You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/deployment/accessing-local-and-remote-data-in-clickonce-applications.md
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -24,11 +24,11 @@ Most applications consume or produce data. [!INCLUDE[ndptecclick](../deployment/
24
24
## Local Data
25
25
With [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)], you can load and store data locally by using any one of the following methods:
26
26
27
-
-[!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] Data Directory
27
+
-[!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] Data Directory
28
28
29
-
- Isolated Storage
29
+
-Isolated Storage
30
30
31
-
- Other Local Files
31
+
-Other Local Files
32
32
33
33
### ClickOnce data directory
34
34
Every [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application installed on a local computer has a data directory, stored in the user's Documents and Settings folder. Any file included in a [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application and marked as a "data" file is copied to this directory when an application is installed. Data files can be of any file type, the most frequently used being text, XML, and database files such as Microsoft Access .mdb files.
Copy file name to clipboardExpand all lines: docs/deployment/application-deployment-prerequisites.md
+31-32Lines changed: 31 additions & 32 deletions
Original file line number
Diff line number
Diff line change
@@ -25,60 +25,59 @@ ms.workload:
25
25
# Application deployment prerequisites
26
26
27
27
To have your application to install and run successfully, first install all components upon which your application is dependent onto the target computer. For example, most applications created using [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] have a dependency on the [!INCLUDE[dnprdnshort](../code-quality/includes/dnprdnshort_md.md)]. In this case, the correct version of the common language runtime must be present on the destination computer before the application is installed.
28
-
28
+
29
29
You can select these prerequisites in the **Prerequisites Dialog Box** and install the .NET Framework and any other redistributable as a part of your installation. This practice is known as *bootstrapping*. [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] generates a Windows executable program named *Setup.exe*, also known as a *bootstrapper*. The bootstrapper is responsible for installing these prerequisites before your application runs. For more information about selecting these prerequisites, see [Prerequisites dialog box](../ide/reference/prerequisites-dialog-box.md).
30
-
30
+
31
31
Each prerequisite is a bootstrapper package. A bootstrapper package is a group of directories and files containing the manifest files that describe how the prerequisites are installed. If your application prerequisites are not listed in the **Prerequisite Dialog Box**, you can create custom bootstrapper packages and add them to Visual Studio. Then you can select the prerequisites in the **Prerequisites Dialog Box**. For more information, see [Create bootstrapper packages](../deployment/creating-bootstrapper-packages.md).
32
-
32
+
33
33
By default, bootstrapping is enabled for ClickOnce deployment. The bootstrapper generated for ClickOnce deployment is signed. You can disable bootstrapping for a component, but only if you are sure that the correct version of the component is already installed on all target computers.
34
-
34
+
35
35
## Bootstrapping and ClickOnce deployment
36
36
Before installing an application on a client computer, [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] examines the client to ensure that it has the requirements specified in the application manifest. These include the following requirements:
37
-
38
-
- The minimum required version of the common language runtime, which is specified as an assembly dependency in the application manifest.
39
-
40
-
- The minimum required version of the Windows operating system required by the application, as specified in the application manifest using the `<osVersionInfo>` element. (See [\<dependency> element](../deployment/dependency-element-clickonce-application.md).)
41
-
42
-
- The minimum version of all assemblies that must be preinstalled in the global assembly cache (GAC), as specified by assembly dependency declarations in the assembly manifest.
43
-
44
-
[!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] can detect missing prerequisites, and you can install prerequisites by using a bootstrapper. For more information, see [How to: Install prerequisites with a ClickOnce application](../deployment/how-to-install-prerequisites-with-a-clickonce-application.md).
45
-
37
+
38
+
-The minimum required version of the common language runtime, which is specified as an assembly dependency in the application manifest.
39
+
40
+
-The minimum required version of the Windows operating system required by the application, as specified in the application manifest using the `<osVersionInfo>` element. (See [\<dependency> element](../deployment/dependency-element-clickonce-application.md).)
41
+
42
+
-The minimum version of all assemblies that must be preinstalled in the global assembly cache (GAC), as specified by assembly dependency declarations in the assembly manifest.
43
+
44
+
[!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] can detect missing prerequisites, and you can install prerequisites by using a bootstrapper. For more information, see [How to: Install prerequisites with a ClickOnce application](../deployment/how-to-install-prerequisites-with-a-clickonce-application.md).
45
+
46
46
> [!NOTE]
47
47
> To change the values in the manifests generated by tools such as [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] and *MageUI.exe*, you need to edit the application manifest in a text editor, and then re-sign both the application and deployment manifests. For more information, see [How to: Re-sign application and deployment manifests](../deployment/how-to-re-sign-application-and-deployment-manifests.md).
48
-
48
+
49
49
If you use Visual Studio and ClickOnce to deploy your application, the bootstrapper packages that are selected by default depend on the version of the .NET Framework in the solution. However, if you change the target .NET Framework version, you must update the options in the **Prerequisites Dialog Box** manually.
|.NET Framework 4|.NET Framework 4<br /><br /> Windows Installer 3.1|
55
-
55
+
56
56
With [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] deployment, the *Publish.htm* page generated by the [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] Publish Wizard points either to a link that installs only the application, or to a link that installs both the application and the bootstrapped components.
57
-
57
+
58
58
If you generate the bootstrapper by using the ClickOnce Publish Wizard or the Publish Page in Visual Studio, the *Setup.exe* is automatically signed. However, if you want to use your customer's certificate to sign the bootstrapper, you can sign the file later.
59
-
59
+
60
60
## Bootstrapping and MSBuild
61
61
If you do not use [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)], but rather compile your applications on the command line, you can create the [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] bootstrapping application by using a Microsoft Build Engine (MSBuild) task. For more information, see [GenerateBootstrapper task](../msbuild/generatebootstrapper-task.md).
62
-
62
+
63
63
As an alternative to bootstrapping, you can pre-deploy components using an electronic software distribution system, such as Microsoft Systems Management Server (SMS).
The *Setup.exe* generated by [!INCLUDE[vsprvs](../code-quality/includes/vsprvs_md.md)] and the MSBuild tasks supports the following set of command-line arguments. Any other arguments are forwarded to the application installer.
67
-
67
+
68
68
If you change any bootstrapper options, you must change the unsigned bootstrapper and then later sign the bootstrapper file.
|**-url, -componentsurl**| Shows the stored URL and components url for this set up. |
75
-
|**-url=**`location`| Sets the URL where *Setup.exe* will look for the [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application. |
76
-
|**-componentsurl=**`location`| Sets the URL where *Setup.exe* will look for the dependencies, such as the [!INCLUDE[dnprdnshort](../code-quality/includes/dnprdnshort_md.md)]. |
77
-
|**-homesite=**`true`**|**`false`| When `true`, downloads the dependencies from the preferred location on the vendor's site. This setting overrides the **-componentsurl** setting. When `false`, downloads the dependencies from the URL specified by **-componentsurl**. |
78
-
69
+
70
+
|Command-line argument|Description|
71
+
|---------------------------|-----------------|
72
+
|**-?, -h, -help**|Displays a Help dialog box.|
73
+
|**-url, -componentsurl**|Shows the stored URL and components url for this set up.|
74
+
|**-url=**`location`|Sets the URL where *Setup.exe* will look for the [!INCLUDE[ndptecclick](../deployment/includes/ndptecclick_md.md)] application.|
75
+
|**-componentsurl=**`location`|Sets the URL where *Setup.exe* will look for the dependencies, such as the [!INCLUDE[dnprdnshort](../code-quality/includes/dnprdnshort_md.md)].|
76
+
|**-homesite=**`true`**|**`false`|When `true`, downloads the dependencies from the preferred location on the vendor's site. This setting overrides the **-componentsurl** setting. When `false`, downloads the dependencies from the URL specified by **-componentsurl**.|
77
+
79
78
## Operating system support
80
79
The Visual Studio bootstrapper is not supported on Windows Server 2008 Server Core or Windows Server 2008 R2 Server Core, as they provide a low-maintenance server environment with limited functionality. For example, the Server Core installation option only supports the .NET Framework 3.5 Server Core profile, which cannot run the Visual Studio features that depend on the full .NET Framework.
81
-
80
+
82
81
## See also
83
82
[Choose a ClickOnce deployment strategy](../deployment/choosing-a-clickonce-deployment-strategy.md)
84
83
[ClickOnce security and deployment](../deployment/clickonce-security-and-deployment.md)
0 commit comments