ApplicationDeployment.DownloadFileGroup メソッドとは何？わかりやすく解説 Weblio辞書

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

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

ApplicationDeployment.DownloadFileGroup メソッド

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

一連のオプションファイルを必要に応じてダウンロードします。

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

Visual Basic (宣言)

Public Sub DownloadFileGroup ( _
    groupName As String _
)

Visual Basic (使用法)

Dim instance As ApplicationDeployment
Dim groupName As String

instance.DownloadFileGroup(groupName)

public void DownloadFileGroup (
    string groupName
)

C++

public:
void DownloadFileGroup (
    String^ groupName
)

public void DownloadFileGroup (
    String groupName
)

JScript

public function DownloadFileGroup (
    groupName : String
)

パラメータ

groupName: ダウンロードするファイルの名前付きグループ。ClickOnce アプリケーションで "optional" としてマークされたすべてのファイルには、グループ名が必要です。

例外

例外の種類	条件
ArgumentNullException	groupName パラメータが null または長さ 0 です。

解説

ClickOnce アプリケーションでは、アプリケーションマニフェストで "optional" としてマークされたすべてのファイルは、初期化中または更新中にはダウンロードされません。DownloadFileGroup メソッドを使用すると、名前付きグループに属するすべてのファイルを必要に応じてダウンロードできます。これにより、ユーザーがこれらのファイルを必要としていることを確認するまで、これらのファイルによってネットワークリソースやディスク容量が消費されることはなくなります。

これは、静的ファイルだけでなく、アプリケーションで必要としない可能性があるアセンブリに対しても機能します。たとえば、一部のユーザーがアプリケーションに含まれているデータ分析パッケージを日常的に使用する必要があり、その他のユーザーはそのパッケージをまったく起動することがない場合などです。アセンブリを必要に応じてダウンロードするには、CurrentDomain の AssemblyResolve イベントにイベントリスナを追加します。例については、チュートリアル : デザイナを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードするのトピックを参照してください。

すべてのアセンブリは、ClickOnce アプリケーションのキャッシュにダウンロードされます。

すべての静的ファイルは、ClickOnce アプリケーションのデータディレクトリにダウンロードされます。このため、これらのファイルはアプリケーションの現在のバージョンに限定されます。たとえば、アプリケーションがファイルグループをダウンロードし、ユーザーが新しいバージョンをインストールしたと仮定します。後日、ユーザーがアプリケーションを以前のバージョンに戻したとします。この場合、以前のバージョンは、もともとダウンロードしていたファイルのコピーも持つことになります。静的ファイルへのアクセス方法の詳細については、「ClickOnce アプリケーションにおけるローカルデータおよびリモートデータへのアクセス」を参照してください。

DownloadFileGroup は、部分的に信頼されたアプリケーション (アクセス許可が制限された状態で実行している ClickOnce アプリケーション) で動作します。

ClickOnce アプリケーションの一部としてダウンロードされたデータファイルは、特定の規則に従って、あるバージョンから次のバージョンに移行されます。詳細については、「ClickOnce アプリケーションにおけるローカルデータおよびリモートデータへのアクセス」を参照してください。

このメソッドが返されるまで、アプリケーションはユーザー入力に応答しなくなります。ユーザーのワークフローを中断させずにファイルをダウンロードする必要がある場合は、このメソッドではなく DownloadFileGroupAsync メソッドを使用します。

ファイル名だけで単一のファイルをダウンロードする方法はありません。単一のファイルをダウンロードするには、ClickOnce の配置でそのファイルにグループ名を割り当て、このメソッドを使用してそのグループをダウンロードします。

使用例

HelpFiles グループ内のすべてのファイルを同期でディスクにダウンロードするコード例を次に示します。

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

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

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