ApplicationDeployment.DownloadFileGroup メソッド

.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)

C#

public void DownloadFileGroup (
    string groupName
)

C++

public:
void DownloadFileGroup (
    String^ groupName
)

J#

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 グループ内のすべてのファイルを同期でディスクにダウンロードするコード例を次に示します。

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ApplicationDeployment クラス
ApplicationDeployment メンバ
System.Deployment.Application 名前空間
DownloadFileGroupAsync
その他の技術情報
ClickOnce アプリケーション マニフェスト
ClickOnce アプリケーションにおけるローカル データおよびリモート データへのアクセス
方法 : ClickOnce アプリケーションにデータ ファイルを含める
How to: Access an XML File in a ClickOnce Data Directory
ClickOnce キャッシュの概要