ApplicationDeployment.IsFirstRun プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

ApplicationDeployment.IsFirstRun プロパティ

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

クライアントコンピュータでこのアプリケーションを実行したのは今回が初めてかどうかを示す値を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 IsFirstRun As Boolean

Visual Basic (使用法)

Dim instance As ApplicationDeployment
Dim value As Boolean

value = instance.IsFirstRun

public bool IsFirstRun { get;
 }

C++

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

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

JScript

public function get IsFirstRun
 () : boolean

プロパティ値
クライアントコンピュータで、アプリケーションのこのバージョンをこれまで一度も実行していない場合は true。それ以外の場合は false。

解説

IsFirstRun を使用して、アプリケーションを初めて実行するときに、1 回限りの初期化操作を実行する必要があるかどうかを判断します。

IsFirstRun は、アプリケーションのこのインスタンスが、ユーザーにユーザーインターフェイスを表示する最初のインスタンスであるということを示しているわけではありません。システムがプロセスをスケジュールする方法によって、アプリケーションのあるインスタンスが、IsFirstRun プロパティに true を設定していても、最初に画面に表示されるのは別のインスタンスである可能性もあります。このプロパティの値は、ユーザーがあるバージョンから次のバージョンにアップグレードするたびにリセットされます。アプリケーションの任意のバージョンを一番最初に実行したときに操作を実行する場合は、初めて作成したファイルが存在するかどうかをチェックしたり、[アプリケーション設定] を使用してフラグを格納したりするなどの、追加テストを実行する必要があります。

使用例

IsFirstRun を使用して、HelpFiles ファイルグループに対する更新をチェックするかどうかを決定するコード例を次に示します。1 つ以上のファイルが更新されている場合は、DownloadFileGroup を呼び出して新しいバージョンを取得します。

private void DownloadFileGroupSync(string
 fileGroup)
{
    if (ApplicationDeployment.IsNetworkDeployed)
    {
        ApplicationDeployment deployment = ApplicationDeployment.CurrentDeployment;

        if (deployment.IsFirstRun)
        {
            try
            {
                if (deployment.IsFileGroupDownloaded(fileGroup))
                {
                    deployment.DownloadFileGroup(fileGroup);
                } 
            }
            catch (InvalidOperationException ioe)
            {
                MessageBox.Show("This application is not a ClickOnce application.
 Error: " + ioe.Message);
                return;
            }

            downloadStatus.Text = String.Format("Download of file group {0}
 complete.", fileGroup);
        }
    }            
}