ApplicationDeployment.DownloadFileGroupCompleted イベントとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

ApplicationDeployment.DownloadFileGroupCompleted イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ファイルのダウンロードが完了すると、メインアプリケーションスレッドで発生します。

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

Visual Basic (宣言)

Public Event DownloadFileGroupCompleted As
 DownloadFileGroupCompletedEventHandler

Visual Basic (使用法)

Dim instance As ApplicationDeployment
Dim handler As DownloadFileGroupCompletedEventHandler

AddHandler instance.DownloadFileGroupCompleted, handler

public event DownloadFileGroupCompletedEventHandler DownloadFileGroupCompleted

C++

public:
event DownloadFileGroupCompletedEventHandler^ DownloadFileGroupCompleted {
    void add (DownloadFileGroupCompletedEventHandler^ value);
    void remove (DownloadFileGroupCompletedEventHandler^ value);
}

/** @event */
public void add_DownloadFileGroupCompleted
 (DownloadFileGroupCompletedEventHandler value)

/** @event */
public void remove_DownloadFileGroupCompleted
 (DownloadFileGroupCompletedEventHandler value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

DownloadFileGroupCompleted イベントは、メインアプリケーションスレッドで呼び出されます。このコールバックでアプリケーションの Windows フォームコントロールを直接呼び出すことはスレッドセーフです。

このコールバックに提供される、AsyncCompletedEventArgs の Error プロパティをチェックします。このプロパティが null 参照 (Visual Basic では Nothing) の場合は、ダウンロードが成功しており、null 参照 (Visual Basic では Nothing) でない場合は、インストールに失敗しています。この詳細情報は、Error プロパティで確認できます。

DownloadFileGroupAsync メソッドによってダウンロードを開始した場合は、UserState プロパティを使用して、渡したステータス情報にアクセスできます。

使用例

ヘルプファイルのグループをバックグラウンドでダウンロードするコード例を次に示します。この例では、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.");
    }
}

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ApplicationDeployment クラス
ApplicationDeployment メンバ
System.Deployment.Application 名前空間

このページでは「.NET Framework クラスライブラリリファレンス」からApplicationDeployment.DownloadFileGroupCompleted イベントを検索した結果を表示しています。
Weblioに収録されているすべての辞書からApplicationDeployment.DownloadFileGroupCompleted イベントを検索する場合は、下記のリンクをクリックしてください。

全ての辞書からApplicationDeployment.DownloadFileGroupCompleted イベントを検索

>> 「ApplicationDeployment.DownloadFileGroupCompleted イベント」を含む用語の索引
ApplicationDeployment.DownloadFileGroupCompleted イベントのページへのリンク


	© 2025 Microsoft.All rights reserved.

ApplicationDeployment.DownloadFileGroupCompleted イベントとは？ わかりやすく解説

ApplicationDeployment.DownloadFileGroupCompleted イベント

急上昇のことば

ApplicationDeployment.DownloadFileGroupCompleted イベントとは？わかりやすく解説