DeploymentDownloadException クラスとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DeploymentDownloadException クラス

メモ : このクラスは、.NET Framework version 2.0 で新しく追加されたものです。

ClickOnce マニフェストまたは配置のファイルをクライアントコンピュータにダウンロードする際にエラーが発生したことを示します。

名前空間: System.Deployment.Application
アセンブリ: System.Deployment (system.deployment.dll 内)
構文

Visual Basic (宣言)

<SerializableAttribute> _
Public Class DeploymentDownloadException
    Inherits DeploymentException

Visual Basic (使用法)

Dim instance As DeploymentDownloadException

[SerializableAttribute] 
public class DeploymentDownloadException :
 DeploymentException

C++

[SerializableAttribute] 
public ref class DeploymentDownloadException
 : public DeploymentException

/** @attribute SerializableAttribute() */ 
public class DeploymentDownloadException extends
 DeploymentException

JScript

SerializableAttribute 
public class DeploymentDownloadException extends
 DeploymentException

解説

DeploymentDownloadException は、ユーザーが ClickOnce アプリケーションの更新をダウンロードしようとしたときに、次のような複数の問題が発生したことを示します。

クライアントのコンピュータのネットワーク接続がダウンしている。
更新をホストしている Web サーバー、FTP サーバー、またはファイル共有が使用できない。
ClickOnce 配置で 1 つ以上のファイルが見つからなかった。

例外に関する詳細なエラー情報を取得するには、ClickOnce のエラーログを参照してください。詳細については、「ClickOnce 配置のトラブルシューティング」を参照してください。

使用例

アプリケーションの更新を同期的にインストールし、マニフェストまたは配置のファイルをダウンロードする際に問題が発生したかどうかをユーザーに報告するコード例を次に示します。

Visual Basic

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

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);
            }
        }
    }
}

C++

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();
        }
    }

継承階層

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

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。