ConsoleApplicationBase.Deployment Property

Reference

Definition

Namespace:: Microsoft.VisualBasic.ApplicationServices

Assembly:: Microsoft.VisualBasic.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the current application's ClickOnce deployment object, which provides support for updating the current deployment programmatically and support for the on-demand download of files.

public:
 property System::Deployment::Application::ApplicationDeployment ^ Deployment { System::Deployment::Application::ApplicationDeployment ^ get(); };

public System.Deployment.Application.ApplicationDeployment Deployment { get; }

member this.Deployment : System.Deployment.Application.ApplicationDeployment

Public ReadOnly Property Deployment As ApplicationDeployment

Property Value

ApplicationDeployment

The ApplicationDeployment object for the application's ClickOnce deployment.

Exceptions

InvalidDeploymentException

The application is not deployed as a ClickOnce application.

Examples

This example downloads and installs the update after checking that the application is network-deployed. The Update method does not update the application unless it is out of date. The application has to restart to use the update.

Sub UpdateApplication()
    If My.Application.IsNetworkDeployed Then
        My.Application.Deployment.Update()
    End If
End Sub

Only applications that are ClickOnce deployed can be updated using the My.Application.Deployment object. For more information on deploying a ClickOnce application, see How to: Publish a ClickOnce Application using the Publish Wizard.

Remarks

The My.Application.Deployment property returns the application's ClickOnce ApplicationDeployment object. The ApplicationDeployment object provides support for updating the current deployment programmatically as well as support for the on-demand download of files. For more information on ClickOnce applications and how to deploy them, see ClickOnce Security and Deployment and Publishing ClickOnce Applications.

Confirm that the IsNetworkDeployed property is True before you access the My.Application.Deployment property. Otherwise, if the application is not deployed using ClickOnce, reading the My.Application.Deployment property results in an InvalidDeploymentException exception. For more information on deploying a ClickOnce application, see How to: Publish a ClickOnce Application using the Publish Wizard.

For more information on using the My.Application.Deployment property, see Overview of the Visual Basic Application Model.

Availability by Project Type

Project type	Available
Windows Forms Application	Yes
Class Library	No
Console Application	Yes
Windows Forms Control Library	No
Web Control Library	No
Windows Service	Yes
Web Site	No

Applies to

Jaa