ApplicationDeployment.CheckForUpdate メソッド

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

ApplicationDeployment.CheckForUpdate メソッド

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

UpdateLocation をチェックし、新しい更新を利用できるかどうかを確認します。

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

Visual Basic (宣言)

Public Function CheckForUpdate As
 Boolean

Visual Basic (使用法)

Dim instance As ApplicationDeployment
Dim returnValue As Boolean

returnValue = instance.CheckForUpdate

C#

public bool CheckForUpdate ()

C++

public:
bool CheckForUpdate ()

J#

public boolean CheckForUpdate ()

JScript

public function CheckForUpdate () : boolean

戻り値
新しい更新を利用できる場合は true。それ以外の場合は false。

例外

例外の種類	条件
InvalidOperationException	更新が既に実行中であるときにこのメソッドを呼び出すと、ClickOnce は即座にこの例外をスローします。
DeploymentDownloadException	配置マニフェストをダウンロードできません。この例外は、CheckForUpdateCompleted イベントの Error プロパティで確認できます。
InvalidDeploymentException	配置マニフェストが破損しています。この問題を解決するには、アプリケーションを再配置する必要があると思われます。この例外は、CheckForUpdateCompleted イベントの Error プロパティで確認できます。

解説

CheckForUpdate は、現在インストールされている配置のバージョンを、UpdateLocation で見つかった配置マニフェストに指定されているバージョンと比較します。サーバー上のバージョンが、インストール済みのバージョンよりも新しい場合は true を返します。

このメソッドは、チェックが完了するまでブロックします。更新を非同期でチェックするには、このメソッドではなく CheckForUpdateAsync メソッドを使用します。

使用例

アプリケーションの更新をチェックし、更新を利用できる場合は同期でインストールするコード例を次に示します。

Visual Basic

Private Sub InstallUpdateSyncWithInfo()
    Dim info As UpdateCheckInfo = Nothing

    If (ApplicationDeployment.IsNetworkDeployed) Then
        Dim AD As ApplicationDeployment = ApplicationDeployment.CurrentDeployment

        Try
            info = AD.CheckForDetailedUpdate()
        Catch dde As DeploymentDownloadException
            MessageBox.Show("The new version of the application
 cannot be downloaded at this time. " + ControlChars.Lf + ControlChars.Lf
 + "Please check your network connection, or try again later. Error: " + dde.Message)
            Return
        Catch ioe As InvalidOperationException
            MessageBox.Show("This application cannot be updated.
 It is likely not a ClickOnce application. Error: " + ioe.Message)
            Return
        End Try

        If (info.UpdateAvailable) Then
            Dim doUpdate As Boolean
 = True

            If (Not info.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 (Not System.Windows.Forms.DialogResult.OK
 = dr) Then
                    doUpdate = False
                End If
            End If

            If (doUpdate) Then
                Try
                    AD.Update()
                    MessageBox.Show("The application has been
 upgraded, and will now restart.")
                    Application.Restart()
                Catch dde As DeploymentDownloadException
                    MessageBox.Show("Cannot install the latest
 version of the application. " + ControlChars.Lf + ControlChars.Lf +
 "Please check your network connection, or try again later.")
                    Return
                End Try
            End If
        End If
    End If
End Sub

C#

private void InstallUpdateSyncWithInfo()
{
    UpdateCheckInfo info = null;

    if (ApplicationDeployment.IsNetworkDeployed)
    {
        ApplicationDeployment ad = ApplicationDeployment.CurrentDeployment;

        try
        {
            info = ad.CheckForDetailedUpdate();

        }
        catch (DeploymentDownloadException dde)
        {
            MessageBox.Show("The new version of the application
 cannot be downloaded at this time. \n\nPlease check your network
 connection, or try again later. Error: " + dde.Message);
            return;
        }
        catch (InvalidDeploymentException ide)
        {
            MessageBox.Show("Cannot check for a new
 version of the application. The ClickOnce deployment is corrupt. Please redeploy
 the application and try again. Error: " + ide.Message);
            return;
        }
        catch (InvalidOperationException ioe)
        {
            MessageBox.Show("This application cannot be updated. It is likely
 not a ClickOnce application. Error: " + ioe.Message);
            return;
        }

        if (info.UpdateAvailable)
        {
            Boolean doUpdate = true;

            if (!info.IsUpdateRequired)
            {
                DialogResult dr = MessageBox.Show("An update is available. Would
 you like to update the application now?", "Update Available", MessageBoxButtons.OKCancel);
                if (!(DialogResult.OK == dr))
                {
                    doUpdate = false;
                }
            }

            if (doUpdate)
            {
                try
                {
                    ad.Update();
                    MessageBox.Show("The application has been upgraded, and
 will now restart.");
                    Application.Restart();
                }
                catch (DeploymentDownloadException dde)
                {
                    MessageBox.Show("Cannot install the latest version of the
 application. \n\nPlease check your network connection, or try
 again later. Error: " + dde);
                    return;
                }
            }
        }
    }
}

C++

public:
    void InstallUpdateSync()
    {
        if (ApplicationDeployment::IsNetworkDeployed)
        {
            bool isUpdateAvailable = false;
            ApplicationDeployment^ appDeployment =
                ApplicationDeployment::CurrentDeployment;

            try
            {
                isUpdateAvailable = appDeployment->CheckForUpdate();
            }
            catch (InvalidOperationException^ ex)
            {
                MessageBox::Show("The update check failed. Error: {0}"
,
                    ex->Message);
                return;
            }

            if (isUpdateAvailable)
            {
                try
                {
                    appDeployment->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 名前空間
CheckForUpdateAsync