This documentation is archived and is not being maintained.

DeploymentDownloadException Class

Indicates that there was an error downloading either the ClickOnce manifests or the deployment's files to the client computer. 

Namespace:  System.Deployment.Application
Assembly:  System.Deployment (in System.Deployment.dll)

'Declaration
<SerializableAttribute> _
Public Class DeploymentDownloadException _
	Inherits DeploymentException
'Usage
Dim instance As DeploymentDownloadException

A DeploymentDownloadException can indicate that a number of problems occurred when the user tried to download a ClickOnce application update:

  • The client's computer's network connection is down.

  • The Web server, FTP server, or file share hosting the update is unavailable.

  • One or more of the files in the ClickOnce deployment was not found.

To obtain detailed error information about an exception, consult the ClickOnce error log. For more information, see Troubleshooting ClickOnce Deployments.

The following code example installs an application update synchronously, and reports to the user if there was a problem downloading either the manifests or the deployment's files.

Private Sub InstallUpdateSync()
    If (ApplicationDeployment.IsNetworkDeployed) Then 
        Dim updateAvailable As Boolean = False 
        Dim AD As ApplicationDeployment = ApplicationDeployment.CurrentDeployment

        Try
            updateAvailable = AD.CheckForUpdate()
        Catch dde As DeploymentDownloadException
            ' This exception occurs if a network error or disk error occurs 
            ' when downloading the deployment.
            MessageBox.Show("The application cannot check for the existence of a new version at this time. " & ControlChars.Lf & ControlChars.Lf & "Please check your network connection, or try again later. Message: " & dde.Message)
            Exit Sub 
        Catch ide As InvalidDeploymentException
            MessageBox.Show("The application cannot check for an update. The ClickOnce deployment is corrupt. Please redeploy the application and try again. Message: " & ide.Message)
            Exit Sub 
        Catch ioe As InvalidOperationException
            MessageBox.Show("The application cannot check for an update. This most likely happened because the application is already updating. Message: " & ioe.Message)
            Exit Sub 
        End Try 

        If (updateAvailable) Then 
            Try
                AD.Update()
                MessageBox.Show("The application has been upgraded, and will now restart.")
                Application.Restart()
            Catch dde As DeploymentDownloadException
                MessageBox.Show("Cannot install the latest version of the application. " + ControlChars.Lf + ControlChars.Lf + "Please check your network connection, or try again later.")
            End Try 
        End If 
    End If 
End Sub

System.Object
  System.Exception
    System.SystemException
      System.Deployment.Application.DeploymentException
        System.Deployment.Application.DeploymentDownloadException

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Show: