UpdateCheckInfo.IsUpdateRequired プロパティ

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

UpdateCheckInfo.IsUpdateRequired プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

更新をインストールする必要があるかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 IsUpdateRequired As Boolean

Visual Basic (使用法)

Dim instance As UpdateCheckInfo
Dim value As Boolean

value = instance.IsUpdateRequired

C#

public bool IsUpdateRequired { get;
 }

C++

public:
property bool IsUpdateRequired {
    bool get ();
}

J#

/** @property */
public boolean get_IsUpdateRequired ()

JScript

public function get IsUpdateRequired
 () : boolean

プロパティ値
更新が必要な場合は true。それ以外の場合は false。

解説

ClickOnce アプリケーションに更新を配置するときは、その更新を必須の更新としてマークし、即座にアップグレードを行う必要があることをアプリケーションに通知できます。最新バージョンに重大な更新が含まれる場合や、前のバージョンで使用されているファイル形式やバック エンド データ ソースと互換性がない場合は、更新を必須としてマークする必要があります。

使用例

IsUpdateRequired を使用して、ユーザーに更新をインストールするよう要求するか、または要求メッセージを表示せずに更新をインストールするかを決定するコード例を次に示します。

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

            }
        }
    }

プラットフォーム

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

参照

関連項目
UpdateCheckInfo クラス
UpdateCheckInfo メンバ
System.Deployment.Application 名前空間
MinimumRequiredVersion