UpdateCheckInfo

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

UpdateCheckInfo クラス

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

CheckForDetailedUpdate の呼び出しによって取得した詳細な更新情報を表します。

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

Visual Basic (宣言)

Public Class UpdateCheckInfo

Visual Basic (使用法)

Dim instance As UpdateCheckInfo

C#

public class UpdateCheckInfo

C++

public ref class UpdateCheckInfo

J#

public class UpdateCheckInfo

JScript

public class UpdateCheckInfo

解説

UpdateCheckInfo を使用すると、最新バージョンに関する情報に基づいて ClickOnce アプリケーションをアップグレードするかどうかを決定できます。UpdateAvailable は、新しい更新が存在するかどうかを示すブール値を返します。AvailableVersion プロパティは、新しいバージョンのバージョン番号を提供し、MinimumRequiredVersion は、コンピュータにインストールされている最も古いバージョンを提供します。IsUpdateRequired は、利用できる最新の更新がユーザーにとって必要かどうかを表します。最後に、UpdateSizeBytes は、更新の合計サイズを表します。

使用例

UpdateAvailable を使用して、アプリケーションの新しい更新が存在するかどうかを判断し、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;
                }

            }
        }
    }

継承階層

System.Object
  System.Deployment.Application.UpdateCheckInfo

スレッド セーフ

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

プラットフォーム

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 メンバ
System.Deployment.Application 名前空間

UpdateCheckInfo プロパティ

パブリック プロパティ

	名前	説明
	AvailableVersion	まだインストールされていない最新バージョンのバージョン番号を取得します。
	IsUpdateRequired	更新をインストールする必要があるかどうかを示す値を取得します。
	MinimumRequiredVersion	ユーザーがコンピュータにインストールしておく必要のある最小のバージョンを取得します。
	UpdateAvailable	まだインストールされていない更新を利用できるかどうかを示す値を取得します。
	UpdateSizeBytes	利用できる更新のサイズを取得します。

参照

関連項目

UpdateCheckInfo クラス
System.Deployment.Application 名前空間

UpdateCheckInfo メソッド

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

UpdateCheckInfo クラス
System.Deployment.Application 名前空間

UpdateCheckInfo メンバ

CheckForDetailedUpdate の呼び出しによって取得した詳細な更新情報を表します。

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

パブリック プロパティ

	名前	説明
	AvailableVersion	まだインストールされていない最新バージョンのバージョン番号を取得します。
	IsUpdateRequired	更新をインストールする必要があるかどうかを示す値を取得します。
	MinimumRequiredVersion	ユーザーがコンピュータにインストールしておく必要のある最小のバージョンを取得します。
	UpdateAvailable	まだインストールされていない更新を利用できるかどうかを示す値を取得します。
	UpdateSizeBytes	利用できる更新のサイズを取得します。

パブリック メソッド

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

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

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

参照

関連項目

UpdateCheckInfo クラス
System.Deployment.Application 名前空間