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

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

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

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

ApplicationDeployment イベント

パブリックイベントパブリックイベント

	名前	説明
	CheckForUpdateCompleted	CheckForUpdateAsync の完了時に発生します。
	CheckForUpdateProgressChanged	CheckForUpdateAsync の呼び出しで進行状況の更新を使用できる場合に発生します。
	DownloadFileGroupCompleted	ファイルのダウンロードが完了すると、メインアプリケーションスレッドで発生します。
	DownloadFileGroupProgressChanged	DownloadFileGroupAsync の呼び出しによって開始されたファイルのダウンロード操作で、ステータス情報を使用できる場合に発生します。
	UpdateCompleted	UpdateAsync の呼び出しの結果として、ClickOnce がアプリケーションのアップグレードを完了したときに発生します。
	UpdateProgressChanged	UpdateAsync の呼び出しによって開始された更新操作について、ClickOnce に新しいステータス情報がある場合に発生します。

参照

その他の技術情報

チュートリアル : デザイナを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする

ApplicationDeployment クラス

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

プログラムによる現在の配置の更新と、必要に応じたファイルのダウンロードをサポートします。このクラスは継承できません。

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

Visual Basic (宣言)

Public NotInheritable Class
 ApplicationDeployment

Visual Basic (使用法)

Dim instance As ApplicationDeployment

public sealed class ApplicationDeployment

C++

public ref class ApplicationDeployment sealed

public final class ApplicationDeployment

JScript

public final class ApplicationDeployment

解説

配置マニフェストの subscription 要素によって、自動的に更新をチェックしてインストールするように、ClickOnce アプリケーションを構成できます。ただし、一部のアプリケーションでは、更新に対するより細かい制御が必要です。必須の更新はプログラムによってインストールし、オプションの更新の場合はユーザーの都合に合わせてインストールできるようにユーザーに確認を求めるプロンプトを表示できます。配置マニフェストでサブスクリプションの更新を無効にすることにより、アプリケーションの更新ポリシーを完全に制御できます。また、ClickOnce がアプリケーションを定期的に更新できるようにする ApplicationDeployment と組み合わせて、自動サブスクリプションを使用することもできます。ただし、重要な更新がリリースされた直後にダウンロードするには、ApplicationDeployment を使用します。

CheckForUpdate メソッドまたは CheckForUpdateAsync メソッドを使用すると、配置に利用可能な更新があるかどうか調べることができます。後者のメソッドは、正常に完了すると CheckForUpdateCompleted イベントを発生させます。CheckForDetailedUpdate は、更新のバージョン番号や、その更新が現在のユーザーにとって必須の更新かどうかなど、更新に関する重要な情報を返します。更新を利用できる場合は、Update または UpdateAsync を使用してインストールできます。後者のメソッドは、更新のインストールが完了すると UpdateCompleted イベントを発生させます。サイズの大きい更新の場合は、CheckForUpdateProgressChanged イベントと UpdateProgressChanged イベントによって進行状況の通知を受け取ることができます。また、ProgressChangedEventArgs の情報を使用して、ダウンロードのステータスをユーザーに通知することもできます。

ApplicationDeployment を使用すると、必要に応じてサイズの大きいファイルやアセンブリをダウンロードすることもできます。これらのファイルは、インストール時にダウンロードされないように、配置のアプリケーションマニフェスト内で "optional" としてマークする必要があります。DownloadFileGroup メソッドまたは DownloadFileGroupAsync メソッドを使用すると、アプリケーションの存続期間にいつでもファイルをダウンロードできます。AppDomain クラスの AssemblyResolve イベントのイベントハンドラを提供することによって、アセンブリがメモリに読み込まれる前にダウンロードできます。詳細については、「チュートリアル : デザイナを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする」を参照してください。

メモ
ClickOnce アプリケーションの実行中にアプリケーションを更新した場合、Application の Restart メソッドを呼び出すまで、ユーザーは更新結果を確認できません。このメソッドは、アプリケーションの現在実行中のインスタンスを閉じ、すぐに再起動します。

ApplicationDeployment には、パブリックコンストラクタはありません。ClickOnce アプリケーション内のこのクラスのインスタンスは、CurrentDeployment プロパティを使用して取得します。現在のアプリケーションが ClickOnce アプリケーションかどうかを確認するには、IsNetworkDeployed プロパティを使用します。

ApplicationDeployment では、更新をチェックし、クラスのイベントとして完了コールバックを公開する新しいイベントベースの非同期パターンの概要を使用して、最新のファイルを非同期でダウンロードできます。ApplicationDeployment は、スレッドを開始および管理し、適切な UI スレッドでアプリケーションをコールバックします。これにより、アプリケーションをロックせずに更新できるため、ユーザーは更新のインストール中も作業を続けることができます。更新の実行時にユーザーがすべての作業を中止する必要がある場合は、代わりに同期メソッドを使用することを検討してください。

メモ
非同期更新を実行するには、アプリケーションで System.Deployment 名前空間と System.ComponentModel 名前空間の両方をインポートする必要があります。

使用例

アプリケーションの読み込み時に、新しい更新を利用できるかどうかを確認し、必須の更新の場合は非同期でインストールするコード例を次に示します。

Visual Basic

Private sizeOfUpdate As Long
 = 0

Dim WithEvents ADUpdateAsync As
 ApplicationDeployment

Private Sub UpdateApplication()
    If (ApplicationDeployment.IsNetworkDeployed) Then
        ADUpdateAsync = ApplicationDeployment.CurrentDeployment

        ADUpdateAsync.CheckForUpdateAsync()
    End If
End Sub

Sub ADUpdateAsync_CheckForUpdateProgressChanged(ByVal
 sender As Object, ByVal
 e As DeploymentProgressChangedEventArgs) Handles ADUpdateAsync.CheckForUpdateProgressChanged
    DownloadStatus.Text = [String].Format("{0:D}K of {1:D}K downloaded.",
 e.BytesCompleted / 1024, e.BytesTotal / 1024)
End Sub


Sub ADUpdateAsync_CheckForUpdateCompleted(ByVal
 sender As Object, ByVal
 e As CheckForUpdateCompletedEventArgs) Handles ADUpdateAsync.CheckForUpdateCompleted
    If (e.Error IsNot Nothing) Then
        MessageBox.Show(("ERROR: Could not retrieve new version
 of the application. Reason: " + ControlChars.Lf + e.Error.Message +
 ControlChars.Lf + "Please report this error to the system administrator."))
        Return
    Else
        If (e.Cancelled = True) Then
            MessageBox.Show("The update was cancelled.")
        End If
    End If

    ' Ask the user if they would like to update the application now.
    If (e.UpdateAvailable) Then
        sizeOfUpdate = e.UpdateSizeBytes

        If (Not e.IsUpdateRequired) Then
            Dim dr As DialogResult = MessageBox.Show("An
 update is available. Would you like to update the application now?",
 "Update Available", MessageBoxButtons.OKCancel)
            If (System.Windows.Forms.DialogResult.OK = dr) Then
                BeginUpdate()
            End If
        Else
            MessageBox.Show("A mandatory update is available for
 your application. We will install the update now, after which we will save all
 of your in-progress data and restart your application.")
            BeginUpdate()
        End If
    End If
End Sub

Private Sub BeginUpdate()
    ADUpdateAsync = ApplicationDeployment.CurrentDeployment
    ADUpdateAsync.UpdateAsync()
End Sub


Sub ADUpdateAsync_UpdateProgressChanged(ByVal
 sender As Object, ByVal
 e As DeploymentProgressChangedEventArgs) Handles ADUpdateAsync.UpdateProgressChanged
    Dim progressText As String
 = String.Format("{0:D}K out of {1:D}K downloaded
 - {2:D}% complete", e.BytesCompleted / 1024, e.BytesTotal / 1024, e.ProgressPercentage)
    DownloadStatus.Text = progressText
End Sub


Sub ADUpdateAsync_UpdateCompleted(ByVal sender
 As Object, ByVal e As
 AsyncCompletedEventArgs) Handles ADUpdateAsync.UpdateCompleted
    If (e.Cancelled) Then
        MessageBox.Show("The update of the application's
 latest version was cancelled.")
        Exit Sub
    Else
        If (e.Error IsNot Nothing) Then
            MessageBox.Show("ERROR: Could not install the latest
 version of the application. Reason: " + ControlChars.Lf + e.Error.Message
 + ControlChars.Lf + "Please report this error to the system administrator.")
            Exit Sub
        End If
    End If

    Dim dr As DialogResult = MessageBox.Show("The
 application has been updated. Restart? (If you do not restart now, the new version
 will not take effect until after you quit and launch the application again.)", "Restart Application", MessageBoxButtons.OKCancel)
    If (dr = System.Windows.Forms.DialogResult.OK) Then
        Application.Restart()
    End If
End Sub

long sizeOfUpdate = 0;

private void UpdateApplication()
{
    if (ApplicationDeployment.IsNetworkDeployed)
    {
        ApplicationDeployment ad = ApplicationDeployment.CurrentDeployment;
        ad.CheckForUpdateCompleted += new CheckForUpdateCompletedEventHandler(ad_CheckForUpdateCompleted);
        ad.CheckForUpdateProgressChanged += new DeploymentProgressChangedEventHandler(ad_CheckForUpdateProgressChanged);

        ad.CheckForUpdateAsync();
    }
}

void  ad_CheckForUpdateProgressChanged(object sender, DeploymentProgressChangedEventArgs
 e)
{
    downloadStatus.Text = String.Format("Downloading: {0}. {1:D}K of {2:D}K
 downloaded.", GetProgressString(e.State), e.BytesCompleted/1024, e.BytesTotal/1024);
   
}

string GetProgressString(DeploymentProgressState state)
{
    if (state == DeploymentProgressState.DownloadingApplicationFiles)
    {
        return "application files";
    } 
    else if (state == DeploymentProgressState.DownloadingApplicationInformation)
 
    {
        return "application manifest";
    } 
    else 
    {
        return "deployment manifest";
    }
}

void ad_CheckForUpdateCompleted(object sender, CheckForUpdateCompletedEventArgs
 e)
{
    if (e.Error != null)
    {
        MessageBox.Show("ERROR: Could not retrieve new version
 of the application. Reason: \n" + e.Error.Message + "\nPlease report
 this error to the system administrator.");
        return;
    }
    else if (e.Cancelled == true)
    {
        MessageBox.Show("The update was cancelled.");
    }

    // Ask the user if they would like to update the application now.
    if (e.UpdateAvailable)
    {
        sizeOfUpdate = e.UpdateSizeBytes;

        if (!e.IsUpdateRequired)
        {
            DialogResult dr = MessageBox.Show("An update is available. Would
 you like to update the application now?\n\nEstimated Download Time: ", "Update
 Available", MessageBoxButtons.OKCancel);
            if (DialogResult.OK == dr)
            {
                BeginUpdate();
            }
        }
        else
        {
            MessageBox.Show("A mandatory update is available for
 your application. We will install the update now, after which we will save all
 of your in-progress data and restart your application.");
            BeginUpdate();
        }
    }
}

private void BeginUpdate()
{
    ApplicationDeployment ad = ApplicationDeployment.CurrentDeployment;
    ad.UpdateCompleted += new AsyncCompletedEventHandler(ad_UpdateCompleted);

    // Indicate progress in the application's status bar.
    ad.UpdateProgressChanged += new DeploymentProgressChangedEventHandler(ad_UpdateProgressChanged);
}

void ad_UpdateProgressChanged(object sender, DeploymentProgressChangedEventArgs
 e)
{
    String progressText = String.Format("{0:D}K out of {1:D}K downloaded - {2:D}%
 complete", e.BytesCompleted / 1024, e.BytesTotal / 1024, e.ProgressPercentage);
    downloadStatus.Text = progressText;
}

void ad_UpdateCompleted(object sender, AsyncCompletedEventArgs
 e)
{
    if (e.Cancelled)
    {
        MessageBox.Show("The update of the application's latest version was
 cancelled.");
        return;
    }
    else if (e.Error != null)
    {
        MessageBox.Show("ERROR: Could not install the latest version of the
 application. Reason: \n" + e.Error.Message + "\nPlease report this
 error to the system administrator.");
        return;
    }

    DialogResult dr = MessageBox.Show("The application has been updated. Restart?
 (If you do not restart now, the new version will not take effect
 until after you quit and launch the application again.)", "Restart Application", MessageBoxButtons.OKCancel);
    if (DialogResult.OK == dr)
    {
        Application.Restart();
    }
}

C++

private:
    long sizeOfUpdate;


private:
    void Form1_Load(Object^ sender, System::EventArgs^ e)
    {
        DoUpdate();
    }

public:
    void DoUpdate()
    {
        if (ApplicationDeployment::IsNetworkDeployed)
        {
            ApplicationDeployment^ currentAppDeployment =
                ApplicationDeployment::CurrentDeployment;
            currentAppDeployment->CheckForUpdateCompleted +=
                gcnew CheckForUpdateCompletedEventHandler(
                this, &Form1::currentDeploy_CheckForUpdateCompleted);
            currentAppDeployment->CheckForUpdateAsync();
        }
    }

    // If update is available, fetch it.
    void currentDeploy_CheckForUpdateCompleted(Object^ sender
,
        CheckForUpdateCompletedEventArgs^ e)
    {
        if (nullptr != e->Error)
        {
            // Log error.
            return;
        }

        if (e->UpdateAvailable)
        {
            sizeOfUpdate = (long) e->UpdateSizeBytes;
            if (!e->IsUpdateRequired)
            {
                System::Windows::Forms::DialogResult 
                    updateDialogueResult = MessageBox::Show(
                    "An update is available.Would you like to update the"
 +
                    " application now?", "Update Available",
                    MessageBoxButtons::OKCancel);
                if (System::Windows::Forms::DialogResult::OK ==
 
                    updateDialogueResult)
                {
                    BeginUpdate();
                }
            }
            else
            {
                BeginUpdate();
            }
        }
    }

    void BeginUpdate()
    {
        ApplicationDeployment^ ad = ApplicationDeployment::CurrentDeployment;
        ad->UpdateCompleted +=
            gcnew AsyncCompletedEventHandler(
            this, &Form1::CurrentDeployment_UpdateCompleted);

        // Indicate progress in the application's status bar.
        ad->UpdateProgressChanged +=
            gcnew DeploymentProgressChangedEventHandler(this,
 
            &Form1::ad_ProgressChanged);

        ad->UpdateAsync();
    }

    void CurrentDeployment_UpdateCompleted(Object^ sender,
        AsyncCompletedEventArgs^ e)
    {
        if (!e->Cancelled)
        {
            if (nullptr != e->Error)
            {
                System::Windows::Forms::DialogResult 
                    restartDialogueResult = MessageBox::Show(
                    "The application has been updated. Restart?",
                    "Restart Application",
                    MessageBoxButtons::OKCancel);
                if (System::Windows::Forms::DialogResult::OK ==
 
                    restartDialogueResult)
                {
                    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.");
        }
    }

    void ad_ProgressChanged(Object^ sender,
        DeploymentProgressChangedEventArgs^ e)
    {
        String^ progressText =
            String::Format(
            "{0:D}K out of {1:D}K downloaded - {2:D}% complete",
            e->BytesCompleted / 1024, e->BytesTotal / 1024,
            e->ProgressPercentage);
        statusStrip1->Text = progressText;
    }

継承階層

System.Object
System.Deployment.Application.ApplicationDeployment

スレッドセーフ

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

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
ApplicationDeployment メンバ
System.Deployment.Application 名前空間
その他の技術情報
チュートリアル : デザイナを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする

ApplicationDeployment プロパティ

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

	名前	説明
	TimeOfLastUpdateCheck	ClickOnce がアプリケーションの更新を最後にチェックした日時を取得します。
	UpdatedApplicationFullName	アプリケーションの更新後に、アプリケーションの完全名を取得します。
	UpdatedVersion	最近ダウンロードされた更新のバージョンを取得します。
	UpdateLocation	このアプリケーションの更新元である Web サイトまたはファイル共有を取得します。

参照

その他の技術情報

チュートリアル : デザイナを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする

ApplicationDeployment メソッド

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

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

	名前	説明
	CheckForDetailedUpdate	CheckForUpdate と同じ操作を実行しますが、利用可能な更新の拡張情報を返します。
	CheckForUpdate	UpdateLocation をチェックし、新しい更新を利用できるかどうかを確認します。
	CheckForUpdateAsync	UpdateLocation を非同期でチェックし、新しい更新を利用できるかどうかを確認します。
	CheckForUpdateAsyncCancel	非同期の更新チェックをキャンセルします。
	DownloadFileGroup	一連のオプションファイルを必要に応じてダウンロードします。
	DownloadFileGroupAsync	オーバーロードされます。一連のオプションファイルを、必要に応じてバックグラウンドでダウンロードします。
	DownloadFileGroupAsyncCancel	ファイルの非同期ダウンロードをキャンセルします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsFileGroupDownloaded	クライアントコンピュータに、名前付きファイルグループが既にダウンロードされているかどうかをチェックします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)
	Update	このアプリケーションの最新バージョンの同期ダウンロードとインストールを開始します。
	UpdateAsync	このアプリケーションの最新バージョンの非同期ダウンロードとインストールを開始します。
	UpdateAsyncCancel	UpdateAsync によって開始された非同期更新をキャンセルします。

プロテクトメソッド

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

参照

その他の技術情報

チュートリアル : デザイナを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする

ApplicationDeployment メンバ

プログラムによる現在の配置の更新と、必要に応じたファイルのダウンロードをサポートします。このクラスは継承できません。

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

パブリックプロパティ

	名前	説明
	TimeOfLastUpdateCheck	ClickOnce がアプリケーションの更新を最後にチェックした日時を取得します。
	UpdatedApplicationFullName	アプリケーションの更新後に、アプリケーションの完全名を取得します。
	UpdatedVersion	最近ダウンロードされた更新のバージョンを取得します。
	UpdateLocation	このアプリケーションの更新元である Web サイトまたはファイル共有を取得します。

パブリックメソッド

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

	名前	説明
	CheckForDetailedUpdate	CheckForUpdate と同じ操作を実行しますが、利用可能な更新の拡張情報を返します。
	CheckForUpdate	UpdateLocation をチェックし、新しい更新を利用できるかどうかを確認します。
	CheckForUpdateAsync	UpdateLocation を非同期でチェックし、新しい更新を利用できるかどうかを確認します。
	CheckForUpdateAsyncCancel	非同期の更新チェックをキャンセルします。
	DownloadFileGroup	一連のオプションファイルを必要に応じてダウンロードします。
	DownloadFileGroupAsync	オーバーロードされます。一連のオプションファイルを、必要に応じてバックグラウンドでダウンロードします。
	DownloadFileGroupAsyncCancel	ファイルの非同期ダウンロードをキャンセルします。
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュアルゴリズムや、ハッシュテーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsFileGroupDownloaded	クライアントコンピュータに、名前付きファイルグループが既にダウンロードされているかどうかをチェックします。
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)
	Update	このアプリケーションの最新バージョンの同期ダウンロードとインストールを開始します。
	UpdateAsync	このアプリケーションの最新バージョンの非同期ダウンロードとインストールを開始します。
	UpdateAsyncCancel	UpdateAsync によって開始された非同期更新をキャンセルします。

プロテクトメソッド

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

パブリックイベント

	名前	説明
	CheckForUpdateCompleted	CheckForUpdateAsync の完了時に発生します。
	CheckForUpdateProgressChanged	CheckForUpdateAsync の呼び出しで進行状況の更新を使用できる場合に発生します。
	DownloadFileGroupCompleted	ファイルのダウンロードが完了すると、メインアプリケーションスレッドで発生します。
	DownloadFileGroupProgressChanged	DownloadFileGroupAsync の呼び出しによって開始されたファイルのダウンロード操作で、ステータス情報を使用できる場合に発生します。
	UpdateCompleted	UpdateAsync の呼び出しの結果として、ClickOnce がアプリケーションのアップグレードを完了したときに発生します。
	UpdateProgressChanged	UpdateAsync の呼び出しによって開始された更新操作について、ClickOnce に新しいステータス情報がある場合に発生します。

参照

その他の技術情報

チュートリアル : デザイナを使用し、ClickOnce 配置 API で必要に応じてアセンブリをダウンロードする

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

全ての辞書からapplication deploymentを検索

>> 「application deployment」を含む用語の索引
application deploymentのページへのリンク

application deploymentとは？わかりやすく解説

ApplicationDeployment イベント

関連項目

その他の技術情報

ApplicationDeployment クラス

ApplicationDeployment プロパティ

関連項目

その他の技術情報

ApplicationDeployment メソッド

関連項目

その他の技術情報

ApplicationDeployment メンバ

関連項目

その他の技術情報

「application deployment」の関連用語


	© 2024 Microsoft.All rights reserved.

application deploymentとは？ わかりやすく解説

ApplicationDeployment イベント

関連項目

その他の技術情報

ApplicationDeployment クラス

ApplicationDeployment プロパティ

関連項目

その他の技術情報

ApplicationDeployment メソッド

関連項目

その他の技術情報

ApplicationDeployment メンバ

関連項目

その他の技術情報

急上昇のことば

「application deployment」の関連用語

application deploymentとは？わかりやすく解説