UpdateCheckInfo.UpdateAvailable プロパティ

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

UpdateCheckInfo.UpdateAvailable プロパティ

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

まだインストールされていない更新を利用できるかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 UpdateAvailable As Boolean

Visual Basic (使用法)

Dim instance As UpdateCheckInfo
Dim value As Boolean

value = instance.UpdateAvailable

C#

public bool UpdateAvailable { get;
 }

C++

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

J#

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

JScript

public function get UpdateAvailable
 () : boolean

プロパティ値
アプリケーションの新しいバージョンが利用できる場合は true。それ以外の場合は false。

使用例

UpdateAvailable を調べて、インストールする更新があるかどうかを判断するコード例を次に示します。

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