ApplicationDeployment.CheckForDetailedUpdate メソッド

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

ApplicationDeployment.CheckForDetailedUpdate メソッド

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

CheckForUpdate と同じ操作を実行しますが、利用可能な更新の拡張情報を返します。

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

Visual Basic (宣言)

Public Function CheckForDetailedUpdate As
 UpdateCheckInfo

Visual Basic (使用法)

Dim instance As ApplicationDeployment
Dim returnValue As UpdateCheckInfo

returnValue = instance.CheckForDetailedUpdate

C#

public UpdateCheckInfo CheckForDetailedUpdate ()

C++

public:
UpdateCheckInfo^ CheckForDetailedUpdate ()

J#

public UpdateCheckInfo CheckForDetailedUpdate ()

JScript

public function CheckForDetailedUpdate () :
 UpdateCheckInfo

戻り値
利用可能な更新の UpdateCheckInfo。

例外

例外の種類	条件
InvalidOperationException	現在のアプリケーションは、更新をサポートするように構成されていないか、別の更新チェック操作が既に実行中です。
DeploymentDownloadException	配置マニフェストをダウンロードできません。この例外は、CheckForUpdateCompleted イベントの Error プロパティで確認できます。
InvalidDeploymentException	配置マニフェストが破損しています。このアプリケーションをユーザーに配置する前に、アプリケーションのマニフェストを再作成してください。この例外は、CheckForUpdateCompleted イベントの Error プロパティで確認できます。

解説

CheckForDetailedUpdate メソッドを使用すると、同期呼び出し元は、非同期呼び出し元が CheckForUpdateCompletedEventArgs クラスを使用して取得する拡張情報と同じ情報を取得できます。

使用例

CheckForDetailedUpdate を使用して、最新の更新に関する情報を取得するコード例を次に示します。更新が存在する場合は、その更新が必須の更新の場合にだけ自動的にインストールされます。それ以外の場合は、ユーザーに確認のプロンプトが表示されます。

Visual Basic

Dim WithEvents ADLaunchAppUpdate As
 ApplicationDeployment

Public Sub LaunchAppUpdate()
    If (ApplicationDeployment.IsNetworkDeployed) Then
        ADLaunchAppUpdate = ApplicationDeployment.CurrentDeployment
    End If
End Sub


Sub ADLaunchAppUpdate_UpdateCompleted(ByVal
 sender As Object, ByVal
 e As AsyncCompletedEventArgs) Handles ADLaunchAppUpdate.UpdateCompleted
    If Not (e.Error Is Nothing)
 Then
        MessageBox.Show("Could not install application update.
 Please try again later,  or contact a system administrator.", "Application
 Update Error")
        Exit Sub
    Else
        If (e.Cancelled) Then
            MessageBox.Show("The application update has been cancelled.",
 "Application Update Cancelled")
            Exit Sub
        End If
    End If

    ' Process successful update.
    Dim dr As DialogResult = MessageBox.Show("The
 application has been updated. Restart?", "Restart
 Application", MessageBoxButtons.OKCancel)
    If (System.Windows.Forms.DialogResult.OK = dr) Then
        Application.Restart()
    End If
End Sub

C#

public void LaunchAppUpdate()
{
    if (ApplicationDeployment.IsNetworkDeployed)
    {
        ApplicationDeployment appDeploy = ApplicationDeployment.CurrentDeployment;
        appDeploy.UpdateCompleted += new AsyncCompletedEventHandler(appDeploy_UpdateCompleted);
    }
}

void appDeploy_UpdateCompleted(object sender, AsyncCompletedEventArgs
 e)
{
    if (e.Error != null)
    {
        MessageBox.Show("Could not install application update. Please try
 again later,  or contact a system administrator.", "Application Update
 Error");
        return;
    }
    else if (e.Cancelled)
    {
        MessageBox.Show("The application update has been cancelled.", "Application
 Update Cancelled");
        return;
    }

    // Process successful update.
    DialogResult dr = MessageBox.Show("The application has been updated. Restart?",
 "Restart Application", MessageBoxButtons.OKCancel);
    if (DialogResult.OK == dr)
    {
        Application.Restart();
    }
}

C++

public:
    void InstallUpdateSyncWithInfo()
    {
        if (ApplicationDeployment::IsNetworkDeployed)
        {
            ApplicationDeployment^ deployment =
                ApplicationDeployment::CurrentDeployment;
            UpdateCheckInfo^ updateInfo = nullptr;

            try
            {
                updateInfo = deployment->CheckForDetailedUpdate();
            }
            catch (Exception^ ex)
            {
                MessageBox::Show("The update failed. Error: {0}",
                    ex->Message);
                return;
            }

            if (updateInfo->UpdateAvailable)
            {
                bool doUpdate = true;

                if (!updateInfo->IsUpdateRequired)
                {
                    System::Windows::Forms::DialogResult dr =
                        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))
                    {
                        doUpdate = false;
                    }
                }

                if (doUpdate)
                {
                    try
                    {
                        deployment->Update();
                        MessageBox::Show(
                            "The application has been upgraded, and will "
 +
                            "now restart.");
                        Application::Restart();
                    }
                    catch (Exception^ ex)
                    {
                        MessageBox::Show("The update failed. Error: {0}"
,
                            ex->Message);
                        return;
                    }
                }
            }
        }
    }

.NET Framework のセキュリティ

• PermissionSet  (ローカル コンピュータへのフル アクセスに必要なアクセス許可)。PermissionState (関連する列挙体)

プラットフォーム

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 名前空間