チュートリアル: プライバシープロンプトを使用してカスタムブートストラップを作成する

[アーティクル]
01/16/2024

新しいファイルバージョンとアセンブリバージョンのアセンブリが使用可能になったときに、ClickOnce アプリケーションが自動的に更新されるように構成することができます。ユーザーがこの動作に同意するかどうかを確認するには、プライバシープロンプトを表示します。その後、ユーザーは自動更新のアクセス許可をアプリケーションに付与するかどうかを選択できます。アプリケーションの自動更新が許可されなかった場合、インストールは実行されません。

Note

この記事で紹介する Visual Studio ユーザーインターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。 Visual Studio のエディションや環境設定がお使いのものと異なる場合があります。詳細については、「Visual Studio IDE のカスタマイズ」を参照してください。

プライバシープロンプトを表示するには、アプリケーションの自動更新への同意をユーザーに求めるアプリケーションを作成します。

[ファイル] メニューの [新規作成] をポイントし、 [プロジェクト] をクリックします。
[新しいプロジェクト] ダイアログボックスで、[Windows] をクリックし、[WindowsFormsApplication] をクリックします。
[名前] に「ConsentDialog」と入力し、[OK] をクリックします。
デザイナーで、フォームをクリックします。
プロパティ ウィンドウで、Text プロパティを「更新への同意ダイアログ」に変更します。
ツールボックスで、[すべての Windows フォーム] を展開し、[Label] コントロールをフォームにドラッグします。
デザイナーで、ラベルコントロールをクリックします。
プロパティ ウィンドウで、[表示] の Text プロパティを次のように変更します。

インストールしようとしているアプリケーションでは、Web 上の最新の更新プログラムの確認が行われます。 [同意する] をクリックすると、アプリケーションで更新プログラムを自動的にチェックし、インターネットからインストールすることを承認したことになります。
ツールボックスで、Checkbox コントロールをフォームの中央にドラッグします。
プロパティ ウィンドウで、[レイアウト] の Text プロパティを「同意する」に変更します。
ツールボックスで、Button コントロールをフォームの左下にドラッグします。
プロパティ ウィンドウで、[レイアウト] の Text プロパティを「次へ」に変更します。
プロパティ ウィンドウで、[デザイン] の (Name) プロパティを「ProceedButton」に変更します。
ツールボックスで、Button コントロールをフォームの右下にドラッグします。
プロパティ ウィンドウで、[レイアウト] の Text プロパティを「キャンセル」に変更します。
プロパティ ウィンドウで、[デザイン] の (Name) プロパティを「CancelButton」に変更します。
デザイナーで、[同意する] チェックボックスをダブルクリックして、CheckedChanged イベントハンドラーを生成します。

Form1 のコードファイルで、CheckedChanged イベントハンドラーに次のコードを追加します。

private void checkBox1_CheckedChanged(object sender, EventArgs e)
{
    ProceedButton.Enabled = !ProceedButton.Enabled;
}

Private Sub CheckBox1_CheckedChanged(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CheckBox1.CheckedChanged
    ProceedButton.Enabled = Not ProceedButton.Enabled
End Sub

クラスコンストラクターを更新して、[次へ] ボタンを既定で無効にします。

public Form1()
{
    InitializeComponent();
    ProceedButton.Enabled = false;
}

Public Sub New()
    InitializeComponent()
    ProceedButton.Enabled = False
End Sub

Form1 のコードファイルで、ブール変数の次のコードを追加して、エンドユーザーがオンライン更新に同意したかどうかを追跡します。
- C#
- VB
```
public bool accepted = false;
```
```
Public accepted As Boolean = False
```
デザイナーで、[次へ] ボタンをダブルクリックして、Click イベントハンドラーを生成します。

Form1 のコードファイルで、[次へ] ボタンの Click イベントハンドラーに次のコードを追加します。

private void ProceedButton_Click(object sender, EventArgs e)
{
    if (ProceedButton.Enabled)
    {
        accepted = true;
        this.Close();
    }
}

Private Sub ProceedButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles ProceedButton.Click
    If ProceedButton.Enabled Then
        accepted = True
        Me.Close()
    End If
End Sub

デザイナーで、[キャンセル] ボタンをダブルクリックして、Click イベントハンドラーを生成します。

Form1 のコードファイルで、[キャンセル] ボタンの Click イベントハンドラーに次のコードを追加します。

private void CancelButton_Click(object sender, EventArgs e)
{
    this.Close();
}

Private Sub CancelButton_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles CancelButton.Click
    Me.Close()
End Sub

アプリケーションを更新して、エンドユーザーがオンライン更新に同意しなかった場合にエラーが返されるようにします。

Visual Basic 開発者の場合のみ:
1. ソリューションエクスプローラーで、ConsentDialog をクリックします。
2. [プロジェクト] メニューで、[モジュールの追加] をクリックし、[追加] をクリックします。
3. Module1.vb のコードファイルで、次のコードを追加します。
```
Module Module1

    Function Main() As Integer
        Application.EnableVisualStyles()
        Application.SetCompatibleTextRenderingDefault(False)
        Dim f As New Form1()
        Application.Run(f)
        If (Not f.accepted) Then
            Return -1
        Else
            Return 0
        End If
    End Function

End Module
```
4. [プロジェクト] メニューで、[ConsentDialog のプロパティ] をクリックし、[アプリケーション] タブをクリックします。
5. [アプリケーションフレームワークを有効にする] をオフにします。
6. [スタートアップオブジェクト] ドロップダウンメニューで、[Module1] を選択します。
  
  Note
  
  アプリケーションフレームワークを無効にすると、ビジュアルスタイル、アプリケーションイベント、スプラッシュスクリーン、単一インスタンスアプリケーションなどの機能が無効になります。詳細については、「[アプリケーション] ページ (プロジェクトデザイナー) (Visual Basic)」を参照してください。
  
  Visual C# 開発者の場合のみ:
  
  Program.cs のコードファイルを開き、次のコードを追加します。
```
static int Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Form1 f = new Form1();
    Application.Run(f);
    if (!f.accepted)
        return -1;
    else
        return 0;
}
```
[ビルド] メニューで、[ソリューションのビルド] をクリックします。

カスタムブートストラップパッケージを作成する

エンドユーザーにプライバシーに関する確認メッセージを表示するには、Update Consent Dialog アプリケーション用のカスタムブートストラップパッケージを作成し、すべての ClickOnce アプリケーションに必須コンポーネントとして含めます。

この手順では、次のドキュメントを作成してカスタムブートストラップパッケージを作成する方法を示します。

ブートストラップの内容を記述した product.xml マニフェストファイル。
パッケージのローカライズ関連の内容物 (文字列やソフトウェアライセンス条項など) をリストした package.xml マニフェストファイル。
ソフトウェアライセンス条項のドキュメント。

手順 1: ブートストラップディレクトリを作成するには

%PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages に、UpdateConsentDialog という名前のディレクトリを作成します。

Note

このフォルダーを作成するには、管理特権が必要な場合があります。
UpdateConsentDialog ディレクトリで、en という名前のサブディレクトリを作成します。

Note

ロケールごとに新しいディレクトリを作成してください。たとえば、fr や de ロケール用のサブディレクトリを追加するなどします。これらのディレクトリには、フランス語とドイツ語の文字列と言語パックが含められます (必要な場合)。

手順 2: product.xml マニフェストファイルを作成するには

product.xml というテキストファイルを作成します。

product.xml ファイルで、次の XML コードを追加します。既存の XML コードを上書きしないようにしてください。

<Product
  xmlns="http://schemas.microsoft.com/developer/2004/01/bootstrapper"
  ProductCode="Microsoft.Sample.EULA">
  <!-- Defines the list of files to be copied on build. -->
  <PackageFiles CopyAllPackageFiles="false">
    <PackageFile Name="ConsentDialog.exe"/>
  </PackageFiles>

  <!-- Defines how to run the Setup package.-->
  <Commands >
    <Command PackageFile = "ConsentDialog.exe" Arguments=''>
      <ExitCodes>
        <ExitCode Value="0" Result="Success" />
        <ExitCode Value="-1" Result="Fail" String="AU_Unaccepted" />
        <DefaultExitCode Result="Fail"
          FormatMessageFromSystem="true" String="GeneralFailure" />
      </ExitCodes>
    </Command>
  </Commands>

</Product>

ファイルを UpdateConsentDialog ブートストラップディレクトリに保存します。

手順 3: package.xml マニフェストファイルとソフトウェアライセンス条項を作成するには

package.xml というテキストファイルを作成します。

package.xml ファイルで、次の XML コードを追加してロケールを定義し、ソフトウェアライセンス条項を含めます。既存の XML コードを上書きしないようにしてください。

<Package
  xmlns="http://schemas.microsoft.com/developer/2004/01/bootstrapper"
  Name="DisplayName"
  Culture="Culture"
  LicenseAgreement="eula.rtf">
  <PackageFiles>
    <PackageFile Name="eula.rtf"/>
  </PackageFiles>

  <!-- Defines a localizable string table for error messages. -->
  <Strings>
    <String Name="DisplayName">Update Consent Dialog</String>
    <String Name="Culture">en</String>
    <String Name="AU_Unaccepted">The automatic update agreement is not accepted.</String>
    <String Name="GeneralFailure">A failure occurred attempting to launch the setup.</String>
  </Strings>
</Package>

ファイルを、UpdateConsentDialog ブートストラップディレクトリの en サブディレクトリに保存します。
ソフトウェアライセンス条項用に、eula.rtf というドキュメントを作成します。

Note

ソフトウェアライセンス条項には、ライセンス、保証、責任、および現地法に関する情報を含める必要があります。これらのファイルはロケール固有のものである必要があるため、MBCS または UNICODE 文字をサポートする形式でファイルを保存するようにしてください。ソフトウェアライセンス条項の内容については、法務部門に問い合わせてください。
ドキュメントを、UpdateConsentDialog ブートストラップディレクトリの en サブディレクトリに保存します。
必要に応じて、新しい package.xml マニフェストファイルを作成し、各ロケールのソフトウェアライセンス条項用の新しい eula.rtf ドキュメントを作成します。たとえば、fr および de ロケール用のサブディレクトリを作成した場合は、それぞれ個別の package.xml マニフェストファイルとソフトウェアライセンス条項を作成し、それらを fr サブディレクトリと de サブディレクトリに保存します。

Visual Studio では、Update Consent アプリケーションを必須コンポーネントとして設定できます。

ソリューションエクスプローラーで、配置するアプリケーションの名前をクリックします。
[プロジェクト] メニューの ProjectName の [プロパティ] をクリックします。
[発行] ページをクリックし、[必須コンポーネント] をクリックします。
Update Consent Dialog を選択します。

Note

場合によっては、Visual Studio を一度閉じて再度開かないと、[必須コンポーネント] ダイアログボックスに Update Consent Dialog が表示されない場合があります。
[OK] をクリックします。

セットアッププログラムを作成してテストする

Update Consent アプリケーションを必須コンポーネントとして設定したら、アプリケーションのインストーラーとブートストラップを生成することができます。

[同意する] をクリックせずにセットアッププログラムを作成およびテストするには

ソリューションエクスプローラーで、配置するアプリケーションの名前をクリックします。
[プロジェクト] メニューの ProjectName の [プロパティ] をクリックします。
[発行] ページをクリックし、[今すぐ発行] をクリックします。
発行の出力が自動的に開かない場合は、発行の出力に移動します。
Setup.exe プログラムを実行します。

セットアッププログラムで、Update Consent Dialog のソフトウェア使用許諾契約書が表示されます。
ソフトウェア使用許諾契約書を読み、[同意する] をクリックします。

Update Consent Dialog アプリケーションが表示され、次のテキストが表示されます: インストールしようとしているアプリケーションでは、Web 上の最新の更新プログラムの確認が行われます。 [同意する] をクリックすると、アプリケーションでインターネット上の更新プログラムを自動的にチェックすることを承認したことになります。
アプリケーションを閉じるか、[キャンセル] をクリックします。

アプリケーションで次のエラーが表示されます: <アプリケーション名> 用のシステムコンポーネントのインストール中にエラーが発生しました。すべてのシステムコンポーネントが正常にインストールされるまで、セットアップは続行できません。
[詳細] をクリックすると、次のエラーメッセージが表示されます: コンポーネント Update Consent Dialog のインストールに失敗し、次のエラーがメッセージが生成されました: "The automatic update agreement is not accepted." 次のコンポーネントをインストールできませんでした: - Update Consent Dialog
[閉じる] をクリックします。

[同意する] をクリックしてセットアッププログラムを作成およびテストするには

ソリューションエクスプローラーで、配置するアプリケーションの名前をクリックします。
[プロジェクト] メニューの ProjectName の [プロパティ] をクリックします。
[発行] ページをクリックし、[今すぐ発行] をクリックします。
発行の出力が自動的に開かない場合は、発行の出力に移動します。
Setup.exe プログラムを実行します。

セットアッププログラムで、Update Consent Dialog のソフトウェア使用許諾契約書が表示されます。
ソフトウェア使用許諾契約書を読み、[同意する] をクリックします。

Update Consent Dialog アプリケーションが表示され、次のテキストが表示されます: インストールしようとしているアプリケーションでは、Web 上の最新の更新プログラムの確認が行われます。 [同意する] をクリックすると、アプリケーションでインターネット上の更新プログラムを自動的にチェックすることを承認したことになります。
[同意する] をクリックし、[次へ] をクリックします。

アプリケーションのインストールが開始されます。
[アプリケーションのインストール] ダイアログボックスが表示されたら、[インストール] をクリックします。

チュートリアル: プライバシープロンプトを使用してカスタムブートストラップを作成する

カスタムブートストラップパッケージを作成する

手順 1: ブートストラップディレクトリを作成するには

手順 2: product.xml マニフェストファイルを作成するには

手順 3: package.xml マニフェストファイルとソフトウェアライセンス条項を作成するには

セットアッププログラムを作成してテストする

[同意する] をクリックせずにセットアッププログラムを作成およびテストするには

[同意する] をクリックしてセットアッププログラムを作成およびテストするには

フィードバック

フィードバック

その他のリソース

チュートリアル: プライバシー プロンプトを使用してカスタム ブートストラップを作成する

更新への同意に関するダイアログ ボックスを作成する

同意ダイアログ ボックスを作成するには

カスタム ブートストラップ パッケージを作成する

手順 1: ブートストラップ ディレクトリを作成するには

手順 2: product.xml マニフェスト ファイルを作成するには

手順 3: package.xml マニフェスト ファイルとソフトウェア ライセンス条項を作成するには

Update Consent アプリケーションを必須コンポーネントとして設定する

Update Consent アプリケーションを必須コンポーネントとして設定するには

セットアップ プログラムを作成してテストする

[同意する] をクリックせずにセットアップ プログラムを作成およびテストするには

[同意する] をクリックしてセットアップ プログラムを作成およびテストするには

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

チュートリアル: プライバシープロンプトを使用してカスタムブートストラップを作成する

更新への同意に関するダイアログボックスを作成する

同意ダイアログボックスを作成するには

カスタムブートストラップパッケージを作成する

手順 1: ブートストラップディレクトリを作成するには

手順 2: product.xml マニフェストファイルを作成するには

手順 3: package.xml マニフェストファイルとソフトウェアライセンス条項を作成するには

セットアッププログラムを作成してテストする

[同意する] をクリックせずにセットアッププログラムを作成およびテストするには

[同意する] をクリックしてセットアッププログラムを作成およびテストするには