DeploymentProgressChangedEventArgsとは何？わかりやすく解説 Weblio辞書

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

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

DeploymentProgressChangedEventArgs クラス

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

非同期操作で報告される進行状況データを表します。

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

Visual Basic (宣言)

Public Class DeploymentProgressChangedEventArgs
    Inherits ProgressChangedEventArgs

Visual Basic (使用法)

Dim instance As DeploymentProgressChangedEventArgs

public class DeploymentProgressChangedEventArgs
 : ProgressChangedEventArgs

C++

public ref class DeploymentProgressChangedEventArgs
 : public ProgressChangedEventArgs

public class DeploymentProgressChangedEventArgs
 extends ProgressChangedEventArgs

JScript

public class DeploymentProgressChangedEventArgs
 extends ProgressChangedEventArgs

解説

このクラスには、CheckForUpdateProgressChanged イベント、DownloadFileGroupProgressChanged イベント、および UpdateProgressChanged イベントの進行状況を説明するプロパティが含まれています。このクラスのすべてのプロパティが各イベントに適用されるわけではありません。

BytesCompleted および BytesTotal は、それぞれが現在までにダウンロードされた合計バイト数とダウンロード操作の合計バイト数を表し、3 つのイベントすべてに適用されます。Group は、現在の DownloadFileGroupProgressChanged イベントに対応するファイルグループの名前を取得し、State は、ダウンロード操作の現在の段階を反映します。

使用例

HelpFiles という名前のファイルグループをダウンロードして、ステータスバーにダウンロードの進行状況を表示するコード例を次に示します。この例では、Windows フォームアプリケーションを配置し、メインフォームに StatusStrip コントロールと、downloadStatus という名前の ToolStripStatusPanel コントロールを用意する必要があります。

Visual Basic

Dim WithEvents ADDownloadHelpFiles As
 ApplicationDeployment

Private Sub DownloadHelpFiles(ByVal
 GroupName As String)
    If (ApplicationDeployment.IsNetworkDeployed) Then
        ADDownloadHelpFiles = ApplicationDeployment.CurrentDeployment

        If ADDownloadHelpFiles.IsFirstRun Then
            Try
                If ADDownloadHelpFiles.IsFileGroupDownloaded(GroupName)
 Then
                    ADDownloadHelpFiles.DownloadFileGroupAsync(GroupName)
                End If
            Catch ioe As InvalidOperationException
                MessageBox.Show("This application is not a ClickOnce
 application.")
                Return
            End Try
        End If
    End If
End Sub

Sub ADDownloadHelpFiles_DownloadFileGroupProgressChanged(ByVal
 sender As Object, ByVal
 e As DeploymentProgressChangedEventArgs) Handles ADDownloadHelpFiles.DownloadFileGroupProgressChanged
    DownloadStatus.Text = String.Format("Downloading
 file group {0}; {1:D}K of {2:D}K completed.", e.Group, e.BytesCompleted
 / 1024, e.BytesTotal / 1024)
End Sub

Sub ADDownloadHelpFiles_DownloadFileGroupCompleted(ByVal
 sender As Object, ByVal
 e As DownloadFileGroupCompletedEventArgs) Handles ADDownloadHelpFiles.DownloadFileGroupCompleted
    DownloadStatus.Text = String.Format("Download
 of file group {0} complete.", e.Group)
End Sub

private void DownloadFileGroupAsync(string
 fileGroup)
{
    if (ApplicationDeployment.IsNetworkDeployed)
    {
        ApplicationDeployment deployment = ApplicationDeployment.CurrentDeployment;

        try
        {
            if (deployment.IsFileGroupDownloaded(fileGroup))
            {
                deployment.DownloadFileGroupProgressChanged += new
 DeploymentProgressChangedEventHandler(deployment_DownloadFileGroupProgressChanged);
                deployment.DownloadFileGroupCompleted += new DownloadFileGroupCompletedEventHandler(deployment_DownloadFileGroupCompleted);

                deployment.DownloadFileGroupAsync(fileGroup);
            }
        }
        catch (InvalidOperationException ioe)
        {
            MessageBox.Show("This application is not a ClickOnce application.
 Error: " + ioe.Message);
            return;
        }
    }
}

void deployment_DownloadFileGroupProgressChanged(object sender,
 DeploymentProgressChangedEventArgs e)
{
    downloadStatus.Text = String.Format("Downloading file group {0}; {1:D}K
 of {2:D}K completed.", e.Group, e.BytesCompleted / 1024, e.BytesTotal / 1024);
               
}

void deployment_DownloadFileGroupCompleted(object sender, DownloadFileGroupCompletedEventArgs
 e)
{
    if (e.Error != null)
    {
        downloadStatus.Text = "Could not download files. Will try
 again later.";
        return;
    }
    else if (e.Cancelled)
    {
        downloadStatus.Text = "The file download has been cancelled.";
        return;
    }

    downloadStatus.Text = String.Format("Download of file group {0} complete.",
 e.Group);
}

C++

void LaunchAppUpdate()
{
    if (ApplicationDeployment::IsNetworkDeployed)
    {
        ApplicationDeployment^ ad =
            ApplicationDeployment::CurrentDeployment;
        ad->UpdateCompleted +=
            gcnew AsyncCompletedEventHandler(this,
            &Form1::LaunchAppUpdate_UpdateCompleted);

        ad->UpdateAsync();
    }
}

void LaunchAppUpdate_UpdateCompleted(Object^ sender,
    AsyncCompletedEventArgs^ e)
{
    if (!e->Cancelled)
    {
        if (nullptr != e->Error)
        {
            System::Windows::Forms::DialogResult dr =
                MessageBox::Show(
                "The application has been updated. Restart?",
                "Restart Application",
                MessageBoxButtons::OKCancel);
            if (System::Windows::Forms::DialogResult::OK == dr)
            {
                Application::Restart();
            }
        }
        else
        {
            // Replace with your own error reporting or logging.
            MessageBox::Show(
                "The application encountered an error in
 " +
                "downloading the latest update. Error: {0}",
                e->Error->Message);
        }
    }
    else
    {
        // Replace with your own error reporting or logging.
        MessageBox::Show(
            "The update of the application's latest version was " +
            "cancelled.");
    }
}

継承階層

System.Object
   System.EventArgs
     System.ComponentModel.ProgressChangedEventArgs
      System.Deployment.Application.DeploymentProgressChangedEventArgs

スレッドセーフ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DeploymentProgressChangedEventArgs メンバ
System.Deployment.Application 名前空間
DeploymentProgressChangedEventHandler

DeploymentProgressChangedEventArgs プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	BytesCompleted	この操作によって既にダウンロードされているバイト数を取得します。
	BytesTotal	ダウンロード操作の合計バイト数を取得します。
	Group	ダウンロードされるファイルグループの名前を取得します。
	ProgressPercentage	非同期タスクの進行状況の割合を取得します。 ( ProgressChangedEventArgs から継承されます。)
	State	プロセスが現在実行しているアクションを取得します。
	UserState	一意のユーザー状態を取得します。 ( ProgressChangedEventArgs から継承されます。)

参照

DeploymentProgressChangedEventArgs メソッド

パブリックメソッドパブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

DeploymentProgressChangedEventArgs メンバ

非同期操作で報告される進行状況データを表します。

DeploymentProgressChangedEventArgs データ型で公開されるメンバを以下の表に示します。

パブリックプロパティ

	名前	説明
	BytesCompleted	この操作によって既にダウンロードされているバイト数を取得します。
	BytesTotal	ダウンロード操作の合計バイト数を取得します。
	Group	ダウンロードされるファイルグループの名前を取得します。
	ProgressPercentage	非同期タスクの進行状況の割合を取得します。(ProgressChangedEventArgs から継承されます。)
	State	プロセスが現在実行しているアクションを取得します。
	UserState	一意のユーザー状態を取得します。(ProgressChangedEventArgs から継承されます。)

パブリックメソッド

( プロテクトメソッドも参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクトメソッド

	名前	説明
	Finalize	Object がガベージコレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)