Skip to content

Latest commit

 

History

History
114 lines (75 loc) · 6.66 KB

walkthrough-downloading-assemblies-on-demand-with-the-clickonce-deployment-api-using-the-designer.md

File metadata and controls

114 lines (75 loc) · 6.66 KB
Raw
title description ms.date ms.topic dev_langs helpviewer_keywords author ms.author manager ms.subservice
Download assemblies on demand using designer (ClickOnce API)
Learn how to mark certain assemblies in your ClickOnce application as optional by using Designer and download them when the common language runtime needs them.
11/04/2016
conceptual
VB
CSharp
C++
assemblies, downloading [ClickOnce]
Windows applications, ClickOnce deployments
ClickOnce deployment, on-demand download
on-demand assemblies, ClickOnce
mikejo5000
mikejo
mijacobs
deployment

Walkthrough: Download assemblies on demand with the ClickOnce deployment API using the Designer

By default, all the assemblies included in a ClickOnce application are downloaded when the application is first run. However, there might be parts of your application that are used by a small set of the users. In this case, you want to download an assembly only when you create one of its types. The following walkthrough demonstrates how to mark certain assemblies in your application as "optional", and how to download them by using classes in the xref:System.Deployment.Application namespace when the common language runtime demands them.

[!INCLUDEndptecclick]

Note

Your application will have to run in full trust to use this procedure.

Note

The dialog boxes and menu commands you see might differ from those described in Help depending on your active settings or edition. To change your settings, click Import and Export Settings on the Tools menu. For more information, see Reset settings.

Create the projects

To create a project that uses an on-demand assembly with Visual Studio

  1. Create a new Windows Forms project in Visual Studio. On the File menu, point to Add, and then click New Project. Choose a Class Library project in the dialog box and name it ClickOnceLibrary.

    [!NOTE] In Visual Basic, we recommend that you modify the project properties to change the root namespace for this project to Microsoft.Samples.ClickOnceOnDemand or to a namespace of your choice. For simplicity, the two projects in this walkthrough are in the same namespace.

  2. Define a class named DynamicClass with a single property named Message.

    C#

    :::code language="csharp" source="../snippets/csharp/VS_Snippets_Winforms/ClickOnceLibrary/CS/Class1.cs" id="Snippet1":::

    VB

    :::code language="vb" source="../snippets/visualbasic/VS_Snippets_Winforms/ClickOnceLibrary/VB/Class1.vb" id="Snippet1":::

  3. Select the Windows Forms project in Solution Explorer. Add a reference to the xref:System.Deployment.Application assembly and a project reference to the ClickOnceLibrary project.

    [!NOTE] In Visual Basic, we recommend that you modify the project properties to change the root namespace for this project to Microsoft.Samples.ClickOnceOnDemand or to a namespace of your choice. For simplicity, the two projects in this walkthrough are located in the same namespace.

  4. Right-click the form, click View Code from the menu, and add the following references to the form.

    C#

    :::code language="csharp" source="../snippets/csharp/VS_Snippets_Winforms/ClickOnceOnDemand/CS/Form1.cs" id="Snippet1":::

    VB

    :::code language="vb" source="../snippets/visualbasic/VS_Snippets_Winforms/ClickOnceOnDemand/VB/Form1.vb" id="Snippet1":::

  5. Add the following code to download this assembly on demand. This code shows how to map a set of assemblies to a group name using a generic xref:System.Collections.DictionaryBase.Dictionary%2A class. Because we are only downloading a single assembly in this walkthrough, there is only one assembly in our group. In a real application, you would likely want to download all assemblies related to a single feature in your application at the same time. The mapping table enables you to do this easily by associating all the DLLs that belong to a feature with a download group name.

    C#

    :::code language="csharp" source="../snippets/csharp/VS_Snippets_Winforms/ClickOnceOnDemand/CS/Form1.cs" id="Snippet2":::

    VB

    :::code language="vb" source="../snippets/visualbasic/VS_Snippets_Winforms/ClickOnceOnDemand/VB/Form1.vb" id="Snippet2":::

  6. On the View menu, click Toolbox. Drag a xref:System.Windows.Forms.Button from the Toolbox onto the form. Double-click the button and add the following code to the xref:System.Windows.Forms.Control.Click event handler.

    C#

    :::code language="csharp" source="../snippets/csharp/VS_Snippets_Winforms/ClickOnceOnDemand/CS/Form1.cs" id="Snippet3":::

    VB

    :::code language="vb" source="../snippets/visualbasic/VS_Snippets_Winforms/ClickOnceOnDemand/VB/Form1.vb" id="Snippet3":::

Mark assemblies as optional

To mark assemblies as optional in your ClickOnce application by using Visual Studio

  1. Right-click the Windows Forms project in Solution Explorer and click Properties. Select the Publish tab.

  2. Click the Application Files button.

  3. Find the listing for ClickOnceLibrary.dll. Set the Publish Status drop-down box to Include.

  4. Expand the Group drop-down box and select New. Enter the name ClickOnceLibrary as the new group name.

  5. Continue publishing your application as described in How to: Publish a ClickOnce application using the Publish Wizard.

To mark assemblies as optional in your ClickOnce application by using Manifest Generation and Editing Tool — Graphical Client (MageUI.exe)

  1. Create your ClickOnce manifests as described in Walkthrough: Manually deploy a ClickOnce application.

  2. Before closing MageUI.exe, select the tab that contains your deployment's application manifest, and within that tab select the Files tab.

  3. Find ClickOnceLibrary.dll in the list of application files and set its File Type column to None. For the Group column, type ClickOnceLibrary.dll.

Test the new assembly

To test your on-demand assembly:

  1. Start your application deployed with ClickOnce.

  2. When your main form appears, press the xref:System.Windows.Forms.Button. You should see a string in a message box window that reads, "Hello, World!"

Related content

  • xref:System.Deployment.Application.ApplicationDeployment