ApplicationDeployment.IsFirstRun プロパティ

.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

C#

public bool IsFirstRun { get;
 }

C++

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

J#

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

JScript

public function get IsFirstRun
 () : boolean

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

解説

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

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

使用例

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

C#

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

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