ApplicationDeployment.DownloadFileGroupAsync メソッド

定義

一連のオプション ファイルを、必要に応じてバックグラウンドでダウンロードします。Downloads, on demand, a set of optional files in the background.

オーバーロード

DownloadFileGroupAsync(String, Object)

一連のオプション ファイルを、必要に応じてバックグラウンドでダウンロードし、アプリケーションの状態の一部をイベント コールバックに渡します。Downloads, on demand, a set of optional files in the background, and passes a piece of application state to the event callbacks.

DownloadFileGroupAsync(String)

一連のオプション ファイルを、必要に応じてバックグラウンドでダウンロードします。Downloads, on demand, a set of optional files in the background.

DownloadFileGroupAsync(String, Object)

一連のオプション ファイルを、必要に応じてバックグラウンドでダウンロードし、アプリケーションの状態の一部をイベント コールバックに渡します。Downloads, on demand, a set of optional files in the background, and passes a piece of application state to the event callbacks.

public:
 void DownloadFileGroupAsync(System::String ^ groupName, System::Object ^ userState);
public void DownloadFileGroupAsync (string groupName, object userState);
member this.DownloadFileGroupAsync : string * obj -> unit
Public Sub DownloadFileGroupAsync (groupName As String, userState As Object)

パラメーター

groupName
String

ダウンロードするファイルの名前付きグループ。The named group of files to download. ClickOnceClickOnce アプリケーションで "optional" としてマークされたすべてのファイルには、グループ名が必要です。All files marked "optional" in a ClickOnceClickOnce application require a group name.

userState
Object

非同期操作のステータス情報を格納している任意のオブジェクト。An arbitrary object containing state information for the asynchronous operation.

例外

groupName パラメーターが null であるか、長さが 0 です。The groupName parameter is null or zero-length.

一度に groupName の複数のダウンロードを開始することはできません。You cannot initiate more than one download of groupName at a time.

注釈

ClickOnceClickOnce アプリケーションでは、アプリケーションマニフェストで "optional" とマークされたファイルは、初期化または更新中にダウンロードされません。In a ClickOnceClickOnce application, the files marked "optional" in the application manifest are not downloaded during initialization or update. DownloadFileGroupAsync メソッドを使用すると、必要に応じて名前付きグループに属するすべてのファイルをダウンロードし、ユーザーが必要とするまでネットワークリソースとディスク領域を消費しないようにすることができます。You can use the DownloadFileGroupAsync method to download all of the files belonging to a named group on demand, so that they do not consume network resources and disk space until you are sure the user requires them. この方法は、静的ファイルだけでなく、アプリケーションが必要とする可能性のあるアセンブリにも使用できます。This approach works not only for static files, but also for assemblies that an application may or may not require. たとえば、特定のユーザーがアプリケーションに含まれるデータ分析パッケージを日常的に使用する必要があり、他のユーザーがそれを呼び出すことがない場合があります。For example, certain users may need to use a data analysis package included in your application on a daily basis, while other users may never invoke it. 必要に応じてアセンブリをダウンロードするには、CurrentDomainAssemblyResolve イベントにイベントリスナーをアタッチします。To download assemblies on demand, attach an event listener to the AssemblyResolve event on the CurrentDomain.

DownloadFileGroupAsync 方法を使用して、複数のファイルグループを同時にダウンロードできます。You can download multiple file groups simultaneously by using the DownloadFileGroupAsync method. これらを区別するには、DeploymentProgressChangedEventArgs クラスの Group プロパティを使用します。これは DownloadFileGroupProgressChanged イベントに渡されます。You can distinguish among them by using the Group property of the DeploymentProgressChangedEventArgs class, which is passed to the DownloadFileGroupProgressChanged event. より複雑な状態を渡す必要がある場合は、を使用します。If you need to pass a more complex state, you can use

state オブジェクトを渡す DownloadFileGroupAsyncDownloadFileGroupAsync to pass in a state object.

すべての静的ファイルは ClickOnceClickOnce アプリケーションのデータディレクトリにダウンロードされるため、アプリケーションの現在のバージョンに分離されます。All static files are downloaded to the ClickOnceClickOnce application's data directory and are therefore isolated to the current version of the application. 静的ファイルへのアクセスの詳細については、「 ClickOnce アプリケーションでのローカルデータおよびリモートデータへのアクセス」を参照してください。For more information about accessing static files, see Accessing Local and Remote Data in ClickOnce Applications. . たとえば、アプリケーションがファイルグループをダウンロードした後、ユーザーが新しいバージョンのアプリケーションをインストールしたが、それ以降のユーザーが以前のバージョンのアプリケーションに戻すとします。Let's say that after an application downloads a file group, the user installs a new version of the application, but later user reverts to the previous version of the application. この場合、以前のバージョンには、最初にダウンロードしたファイルのコピーが残ります。In this case, the previous version will still have the copies of the files it originally downloaded.

DownloadFileGroup は、部分的に信頼されたアプリケーション、つまり、制限されたアクセス許可で実行されているすべての ClickOnceClickOnce アプリケーションで動作します。DownloadFileGroup works in partially trusted applications, that is, in any ClickOnceClickOnce application running with restricted permission. ただし、アセンブリを動的に読み込む場合は、アプリケーションが完全な信頼を必要とします。However, if you are attempting to load assemblies dynamically, your application will require full trust.

データファイルのオンデマンドダウンロードは現在サポートされていません。On-demand downloading of data files is currently not supported.

非同期ダウンロードをキャンセルするには、DownloadFileGroupAsyncCancel メソッドを呼び出します。To cancel an asynchronous download, call the DownloadFileGroupAsyncCancel method.

こちらもご覧ください

DownloadFileGroupAsync(String)

一連のオプション ファイルを、必要に応じてバックグラウンドでダウンロードします。Downloads, on demand, a set of optional files in the background.

public:
 void DownloadFileGroupAsync(System::String ^ groupName);
public void DownloadFileGroupAsync (string groupName);
member this.DownloadFileGroupAsync : string -> unit
Public Sub DownloadFileGroupAsync (groupName As String)

パラメーター

groupName
String

ダウンロードするファイルの名前付きグループ。The named group of files to download. ClickOnceClickOnce アプリケーションで "optional" としてマークされたすべてのファイルには、グループ名が必要です。All files marked "optional" in a ClickOnceClickOnce application require a group name.

例外

groupName パラメーターが null であるか、長さが 0 です。The groupName parameter is null or zero-length.

一度に groupName の複数のダウンロードを開始することはできません。You cannot initiate more than one download of groupName at a time.

注釈

ClickOnceClickOnce アプリケーションでは、アプリケーションマニフェストで "optional" とマークされたファイルは、初期化または更新中にダウンロードされません。In a ClickOnceClickOnce application, the files marked "optional" in the application manifest are not downloaded during initialization or update. DownloadFileGroupAsync メソッドを使用すると、必要に応じて名前付きグループに属するすべてのファイルをダウンロードし、ユーザーが必要とするまでネットワークリソースとディスク領域を消費しないようにすることができます。You can use the DownloadFileGroupAsync method to download all of the files belonging to a named group on demand, so that they do not consume network resources and disk space until you are sure the user requires them. この方法は、静的ファイルだけでなく、アプリケーションが必要とする可能性のあるアセンブリにも使用できます。This approach works not only for static files, but also for assemblies that an application may or may not require. たとえば、特定のユーザーがアプリケーションに含まれるデータ分析パッケージを日常的に使用する必要があり、他のユーザーがそれを呼び出すことがない場合があります。For example, certain users may need to use a data analysis package included in your application on a daily basis, while other users may never invoke it.

必要に応じてアセンブリをダウンロードするには、CurrentDomainAssemblyResolve イベントにイベントリスナーをアタッチします。To download assemblies on demand, attach an event listener to the AssemblyResolve event on the CurrentDomain. 例については、「チュートリアル: ClickOnce 配置 API を使用して必要に応じてアセンブリをダウンロードする」を参照してください。For an example, see Walkthrough: Downloading Assemblies on Demand with the ClickOnce Deployment API.

すべてのアセンブリが ClickOnceClickOnce アプリケーションキャッシュにダウンロードされます。All assemblies are downloaded to the ClickOnceClickOnce application cache.

すべての静的ファイルは ClickOnceClickOnce アプリケーションのデータディレクトリにダウンロードされるため、アプリケーションの現在のバージョンに分離されます。All static files are downloaded to the ClickOnceClickOnce application's data directory and are therefore isolated to the current version of the application. たとえば、アプリケーションがファイルグループをダウンロードした後、ユーザーが新しいバージョンのアプリケーションをインストールした後で、アプリケーションの以前のバージョンに戻すとします。Let's say that after an application downloads a file group, the user installs a new version of the application, but later reverts to the previous version of the application. この場合、以前のバージョンには、最初にダウンロードしたファイルのコピーが残ります。In this case, the previous version will still have the copies of the files it originally downloaded. 静的ファイルへのアクセスの詳細については、「 ClickOnce アプリケーションでのローカルデータおよびリモートデータへのアクセス」を参照してください。For more information about accessing static files, see Accessing Local and Remote Data in ClickOnce Applications.

DownloadFileGroupAsyncを使用すると、複数のファイルグループを同時にダウンロードできます。You can download multiple file groups simultaneously using DownloadFileGroupAsync. これらを区別するには、DeploymentProgressChangedEventArgs クラスの Group プロパティを使用します。これは DownloadFileGroupProgressChanged イベントに渡されます。You can distinguish among them by using the Group property of the DeploymentProgressChangedEventArgs class, which is passed to the DownloadFileGroupProgressChanged event. より複雑な状態を渡す必要がある場合は、DownloadFileGroupAsync を使用して state オブジェクトを渡すことができます。If you need to pass more complex state, you can use DownloadFileGroupAsync to pass in a state object.

DownloadFileGroup は、部分的に信頼されたアプリケーション、つまり、制限されたアクセス許可で実行されているすべての ClickOnceClickOnce アプリケーションで動作します。DownloadFileGroup works in partially trusted applications, that is, in any ClickOnceClickOnce application running with restricted permission. ただし、アセンブリを動的に読み込む場合は、アプリケーションが完全な信頼を必要とします。However, if you are attempting to load assemblies dynamically, your application will require full trust.

データファイルのオンデマンドダウンロードは現在サポートされていません。On-demand downloading of data files is currently not supported.

ファイル名だけで1つのファイルをダウンロードすることはできません。You cannot download a single file by its file name alone. 1つのファイルをダウンロードするには、ClickOnceClickOnce 展開でグループ名を割り当て、この方法を使用してグループをダウンロードします。To download a single file, assign it a group name in your ClickOnceClickOnce deployment and download the group using this method.

非同期ダウンロードをキャンセルするには、DownloadFileGroupAsyncCancel メソッドを呼び出します。To cancel an asynchronous download, call the DownloadFileGroupAsyncCancel method.

こちらもご覧ください

適用対象