DeploymentDownloadException Class

Definition

Namespace:

System.Deployment.Application

Assembly:

System.Deployment.dll

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

public ref class DeploymentDownloadException : System::Deployment::Application::DeploymentException

[System.Serializable]
public class DeploymentDownloadException : System.Deployment.Application.DeploymentException

[<System.Serializable>]
type DeploymentDownloadException = class
    inherit DeploymentException

Public Class DeploymentDownloadException
Inherits DeploymentException

Inheritance

SystemException

DeploymentException

DeploymentDownloadException

Attributes

SerializableAttribute

Examples

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.

public:
    void LaunchUpdateWithTimeout()
    {
        if (ApplicationDeployment::IsNetworkDeployed)
        {
            ApplicationDeployment^ appDeployment =
                ApplicationDeployment::CurrentDeployment;
            appDeployment->UpdateCompleted +=
                gcnew AsyncCompletedEventHandler(this, 
                &Form1::deploy_UpdateCompleted);

            // The Interval property uses millisecond resolution.
            timer1->Interval = (1000 * 60) * 2;
            timer1->Start();

            appDeployment->UpdateAsync();
        }
    }

private:
    void deploy_UpdateCompleted(Object^ sender,
        AsyncCompletedEventArgs^ e)
    {
        timer1->Stop();
        if (!e->Cancelled)
        {
            if (nullptr == e->Error)
            {
                Application::Restart();
            }
            else
            {
                // Replace with your own error reporting or logging.
                MessageBox::Show(
                    "The update of the application encountered an " +
                    "error. Error message: {0}",
                    e->Error->Message);
            }
        }
        else
        {
            // Replace with your own error reporting or logging.
            MessageBox::Show(
                "The application update was cancelled because the update " +
                "server was unreachable. Please try again later.");
        }
    }

private:
    void timer1_Tick(Object^ sender, EventArgs^ e)
    {
        if (ApplicationDeployment::IsNetworkDeployed)
        {
            ApplicationDeployment::CurrentDeployment->UpdateAsyncCancel();
        }
    }

private void InstallUpdateSync()
{
    if (ApplicationDeployment.IsNetworkDeployed)
    {
        Boolean updateAvailable = false;
        ApplicationDeployment ad = ApplicationDeployment.CurrentDeployment;

        try
        {
            updateAvailable = ad.CheckForUpdate();
        }
        catch (DeploymentDownloadException dde)
        {
            // This exception occurs if a network error or disk error occurs
            // when downloading the deployment.
            MessageBox.Show("The application cannt check for the existence of a new version at this time. \n\nPlease check your network connection, or try again later. Error: " + dde);
            return;
        }
        catch (InvalidDeploymentException ide)
        {
            MessageBox.Show("The application cannot check for an update. The ClickOnce deployment is corrupt. Please redeploy the application and try again. Error: " + ide.Message);
            return;
        }
        catch (InvalidOperationException ioe)
        {
            MessageBox.Show("This application cannot check for an update. This most often happens if the application is already in the process of updating. Error: " + ioe.Message);
            return;
        }

        if (updateAvailable)
        {
            try
            {
                ad.Update();
                MessageBox.Show("The application has been upgraded, and will now restart.");
                Application.Restart();
            }
            catch (DeploymentDownloadException dde)
            {
                MessageBox.Show("Cannot install the latest version of the application. Either the deployment server is unavailable, or your network connection is down. \n\nPlease check your network connection, or try again later. Error: " + dde.Message);
            }
            catch (TrustNotGrantedException tnge)
            {
                MessageBox.Show("The application cannot be updated. The system did not grant the application the appropriate level of trust. Please contact your system administrator or help desk for further troubleshooting. Error: " + tnge.Message);
            }
        }
    }
}

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

Remarks

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.

Constructors

DeploymentDownloadException()	Initializes a new instance of the DeploymentDownloadException class.
DeploymentDownloadException(SerializationInfo, StreamingContext)	Initializes a new instance of the DeploymentDownloadException class.
DeploymentDownloadException(String, Exception)	Initializes a new instance of the DeploymentDownloadException class.
DeploymentDownloadException(String)	Initializes a new instance of the DeploymentDownloadException class with a message that describes the exception.

Methods

GetObjectData(SerializationInfo, StreamingContext)

Sets the SerializationInfo with information about the exception. (Inherited from DeploymentException)

See also

• Troubleshooting ClickOnce Deployments