Freigeben über

Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Bootstrappers zum Anzeigen einer Datenschutz-Eingabeaufforderung

Sie können ClickOnce-Anwendungen so konfigurieren, dass sie automatisch aktualisiert werden, wenn Assemblys mit neueren Dateiversionen und Assemblyversionen verfügbar sind. Um sicherzustellen, dass Ihre Kunden diesem Verhalten zustimmen, können Sie ihnen eine Datenschutzaufforderung anzeigen. Anschließend können sie auswählen, ob der Anwendung die Berechtigung erteilt werden soll, automatisch zu aktualisieren. Wenn die Anwendung nicht automatisch aktualisiert werden darf, wird sie nicht installiert.

Hinweis

Die Anweisungen in diesem Artikel veranschaulichen die neueste Version der interaktiven Entwicklungsumgebung (Interactive Development Experience, IDE), die in Visual Studio verfügbar ist. Auf Ihrem Computer werden möglicherweise unterschiedliche Namen oder Speicherorte für einige der Benutzeroberflächenelemente angezeigt. Möglicherweise verwenden Sie eine andere Version von Visual Studio oder andere Umgebungseinstellungen. Weitere Informationen finden Sie unter Personalisieren der IDE-.

Um eine Datenschutzaufforderung anzuzeigen, erstellen Sie eine Anwendung, die den Leser auffordert, automatischen Updates für die Anwendung zuzustimmen.

  1. Zeigen Sie im Menü Datei auf Neu, und klicken Sie dann auf Projekt.

  2. Klicken Sie im Dialogfeld "Neues Projekt " auf Windows, und klicken Sie dann auf "WindowsFormsApplication".

  3. Geben Sie für den Namen"ConsentDialog" ein, und klicken Sie dann auf "OK".

  4. Klicken Sie im Designer auf das Formular.

  5. Ändern Sie im Eigenschaftenfenster die Texteigenschaft zu "Zustimmung aktualisieren"-Dialog.

  6. In der Toolbox erweitern Sie Alle Windows Forms und ziehen ein Label-Steuerelement in das Formular.

  7. Klicken Sie im Designer auf das Beschriftungselement.

  8. Ändern Sie im Eigenschaftenfenster die Texteigenschaft unter "Darstellung " wie folgt:

    Die Anwendung, die Sie installieren möchten, sucht nach den neuesten Updates im Web. Durch Klicken auf "Ich stimme zu", autorisieren Sie die Anwendung, automatisch über das Internet nach Updates zu suchen und zu installieren.

  9. Ziehen Sie in der Toolbox ein Kontrollkästchen-Steuerelement in die Mitte des Formulars.

  10. Ändern Sie im Eigenschaftenfenster die Texteigenschaft unter "Layout" in "Ich stimme zu".

  11. Ziehen Sie in der Toolbox ein Schaltflächen-Steuerelement auf die untere linke Ecke des Formulars.

  12. Ändern Sie im Fenster Eigenschaften die Text-Eigenschaft unter Layout in Vorgang fortsetzen.

  13. Ändern Sie im Eigenschaftenfenster die Eigenschaft (Name) unter Entwurf in ProceedButton.

  14. Ziehen Sie in der Toolbox ein Schaltflächen-Steuerelement nach rechts unten im Formular.

  15. Ändern Sie im Eigenschaftenfenster die Texteigenschaft unter "Layout " in "Abbrechen".

  16. Ändern Sie im Eigenschaftenfenster die Eigenschaft (Name) im Bereich Entwurf in CancelButton.

  17. Doppelklicken Sie im Designer auf das Kontrollkästchen "Ich stimme zu" , um den CheckedChanged-Ereignishandler zu generieren.

  18. Fügen Sie in der Formular1-Codedatei den folgenden Code für den CheckedChanged-Ereignishandler hinzu.

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

  19. Aktualisieren Sie den Klassenkonstruktor, um die Schaltfläche "Weiter" standardmäßig zu deaktivieren.

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

  20. Fügen Sie in der Formular1-Codedatei den folgenden Code für eine boolesche Variable hinzu, um nachzuverfolgen, ob der Endbenutzer Onlineupdates zugestimmt hat.

    public bool accepted = false;

  21. Doppelklicken Sie im Designer auf die Schaltfläche "Weiter" , um den Click-Ereignishandler zu generieren.

  22. Fügen Sie in der Formular1-Codedatei dem Click-Ereignishandler für die Schaltfläche "Weiter " den folgenden Code hinzu.

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

  23. Doppelklicken Sie im Designer auf die Schaltfläche "Abbrechen ", um den Click-Ereignishandler zu generieren.

  24. Fügen Sie in der Formular1-Codedatei den folgenden Code für den Click-Ereignishandler für die Schaltfläche "Abbrechen " hinzu.

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

  25. Aktualisieren Sie die Anwendung so, dass ein Fehler zurückgegeben wird, wenn der Endbenutzer keine Onlineupdates zustimmt.

    Nur für Visual Basic-Entwickler:

    1. Klicken Sie im Projektmappen-Explorer auf "ConsentDialog".

    2. Klicken Sie im Menü "Projekt " auf "Modul hinzufügen" und dann auf "Hinzufügen".

    3. Fügen Sie in der codedatei Module1.vb den folgenden Code hinzu.

      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. Klicken Sie im Menü "Projekt " auf "ConsentDialog-Eigenschaften", und klicken Sie dann auf die Registerkarte "Anwendung ".

    5. Deaktivieren Sie das Kontrollkästchen "Anwendungsframework aktivieren".

    6. Wählen Sie im Dropdownmenü "Startobjekt " die Option "Modul1" aus.

      Hinweis

      Wenn Sie das Anwendungsframework deaktivieren, werden Features wie visuelle Stile, Anwendungsereignisse, Begrüßungsbildschirm, Anwendung mit einer einzelnen Instanz und vieles mehr deaktiviert. Weitere Informationen finden Sie auf der Anwendungsseite, Project Designer (Visual Basic).

      Nur für Visual C#-Entwickler:

      Öffnen Sie die Program.cs Codedatei, und fügen Sie den folgenden Code hinzu.

      static int Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Form1 f = new Form1();
    Application.Run(f);
    if (!f.accepted)
        return -1;
    else
        return 0;
}

  26. Klicken Sie im Menü " Erstellen " auf "BuildSolution".

Erstellen des benutzerdefinierten Bootstrapperpakets

Zum Anzeigen der Datenschutzaufforderung für Endbenutzer können Sie ein benutzerdefiniertes Bootstrapperpaket für die Anwendung "Zustimmungsdialog aktualisieren" erstellen und als Voraussetzung in alle ClickOnce-Anwendungen einschließen.

Dieses Verfahren veranschaulicht das Erstellen eines benutzerdefinierten Bootstrapperpakets durch Erstellen der folgenden Dokumente:

  • Eine product.xml Manifestdatei zur Beschreibung des Inhalts des Bootstrappers.

  • Eine package.xml Manifestdatei zum Auflisten der lokalisierungsspezifischen Aspekte Ihres Pakets, z. B. Zeichenfolgen und softwarelizenzbedingungen.

  • Ein Dokument für die Softwarelizenzbedingungen.

Schritt 1: So erstellen Sie das Bootstrapper-Verzeichnis

  1. Erstellen Sie ein Verzeichnis namens "UpdateConsentDialog " im %PROGRAMFILES%\Microsoft SDKs\Windows\v7.0A\Bootstrapper\Packages.

    Hinweis

    Möglicherweise benötigen Sie Administratorrechte, um diesen Ordner zu erstellen.

  2. Erstellen Sie im Verzeichnis "UpdateConsentDialog " ein Unterverzeichnis mit dem Namen "en".

    Hinweis

    Erstellen Sie ein neues Verzeichnis für jede Lokalisierung. Sie können z. B. Unterverzeichnisse für "fr" und "de locales" hinzufügen. Diese Verzeichnisse enthalten bei Bedarf die französischen und deutschen Zeichenfolgen und Sprachpakete.

Schritt 2: So erstellen Sie die product.xml Manifestdatei

  1. Erstellen Sie eine Textdatei namensproduct.xml.

  2. Fügen Sie in der dateiproduct.xml den folgenden XML-Code hinzu. Stellen Sie sicher, dass Sie den vorhandenen XML-Code nicht überschreiben.

    <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>

  3. Speichern Sie die Datei im Bootstrapperverzeichnis von UpdateConsentDialog.

Schritt 3: So erstellen Sie die package.xml Manifestdatei und die Softwarelizenzbedingungen

  1. Erstellen Sie eine Textdatei namenspackage.xml.

  2. Fügen Sie in der dateipackage.xml den folgenden XML-Code hinzu, um das Gebietsschema zu definieren und die Softwarelizenzbedingungen einzuschließen. Stellen Sie sicher, dass Sie den vorhandenen XML-Code nicht überschreiben.

    <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>

  3. Speichern Sie die Datei im Unterverzeichnis "en" im Bootstrapperverzeichnis "UpdateConsentDialog".

  4. Erstellen Sie ein Dokument namens eula.rtf für die Softwarelizenzbedingungen.

    Hinweis

    Die Softwarelizenzbedingungen sollten Informationen zu Lizenzierung, Garantien, Verbindlichkeiten und lokalen Gesetzen enthalten. Diese Dateien sollten gebietsschemaspezifisch sein. Stellen Sie daher sicher, dass die Datei in einem Format gespeichert wird, das MBCS- oder UNICODE-Zeichen unterstützt. Wenden Sie sich an Ihre Rechtsabteilung über den Inhalt der Softwarelizenzbedingungen.

  5. Speichern Sie das Dokument im Unterverzeichnis "en" im Bootstrapperverzeichnis "UpdateConsentDialog ".

  6. Erstellen Sie bei Bedarf eine neue package.xml Manifestdatei und ein neues eula.rtf Dokument für die Softwarelizenzbedingungen für jedes Gebietsschema. Wenn Sie z. B. Unterverzeichnisse für "fr" und "de locales" erstellt haben, erstellen Sie separate package.xml Manifestdateien und Softwarelizenzbedingungen, und speichern Sie sie in den Unterverzeichnissen "fr" und "de".

In Visual Studio können Sie die Update-Zustimmungsanwendung als Voraussetzung festlegen.

  1. Klicken Sie im Projektmappen-Explorer auf den Namen der Anwendung, die Sie bereitstellen möchten.

  2. Klicken Sie im Menü "Projekt " auf "ProjectName-Eigenschaften".

  3. Klicken Sie auf die Seite " Veröffentlichen " und dann auf "Voraussetzungen".

  4. Wählen Sie das Dialogfeld "Zustimmung aktualisieren" aus.

    Hinweis

    Möglicherweise müssen Sie Visual Studio schließen und erneut öffnen, um das Dialogfeld "Aktualisierungszustimmung" im Fenster "Voraussetzungen" zu sehen.

  5. Klicke auf OK.

Erstellen und Testen des Setupprogramms

Nachdem Sie die Update-Zustimmungsanwendung als Voraussetzung festgelegt haben, können Sie das Installationsprogramm und den Bootstrapper für Ihre Anwendung generieren.

So erstellen und testen Sie das Setupprogramm, indem Sie nicht auf "Ich stimme zu" klicken

  1. Klicken Sie im Projektmappen-Explorer auf den Namen der Anwendung, die Sie bereitstellen möchten.

  2. Klicken Sie im Menü "Projekt " auf "ProjectName-Eigenschaften".

  3. Klicken Sie auf die Seite " Veröffentlichen ", und klicken Sie dann auf " Jetzt veröffentlichen".

  4. Wenn die Veröffentlichungsausgabe nicht automatisch geöffnet wird, navigieren Sie zur Veröffentlichungsausgabe.

  5. Führen Sie das Setup.exe Programm aus.

    Das Setupprogramm zeigt den Softwarelizenzvertrag "Update Consent Dialog" an.

  6. Lesen Sie den Softwarelizenzvertrag, und klicken Sie dann auf "Annehmen".

    Die Anwendung "Zustimmungsdialog aktualisieren" wird angezeigt und zeigt den folgenden Text an: Die Anwendung, die Sie installieren möchten, sucht nach den neuesten Updates im Web. Durch Klicken auf "Ich stimme zu" autorisieren Sie die Anwendung, automatisch im Internet nach Updates zu suchen.

  7. Schließen Sie die Anwendung, oder klicken Sie auf 'Abbrechen'.

    Die Anwendung zeigt einen Fehler: Fehler beim Installieren von Systemkomponenten für ApplicationName. Setup kann erst fortgesetzt werden, wenn alle Systemkomponenten erfolgreich installiert wurden.

  8. Klicken Sie auf "Details", um die folgende Fehlermeldung anzuzeigen: Das Dialogfeld "Zustimmung zur Komponentenaktualisierung" konnte mit der folgenden Fehlermeldung nicht installiert werden: "Der Vertrag für automatische Updates ist nicht akzeptiert.". Die folgenden Komponenten konnten nicht installiert werden: – Dialogfeld "Zustimmung aktualisieren"

  9. Klicken Sie auf Schließen.

So erstellen und testen Sie das Setupprogramm, indem Sie auf "Ich stimme zu" klicken

  1. Klicken Sie im Projektmappen-Explorer auf den Namen der Anwendung, die Sie bereitstellen möchten.

  2. Klicken Sie im Menü "Projekt " auf "ProjectName-Eigenschaften".

  3. Klicken Sie auf die Seite " Veröffentlichen ", und klicken Sie dann auf " Jetzt veröffentlichen".

  4. Wenn die Veröffentlichungsausgabe nicht automatisch geöffnet wird, navigieren Sie zur Veröffentlichungsausgabe.

  5. Führen Sie das Setup.exe Programm aus.

    Das Setupprogramm zeigt den Softwarelizenzvertrag "Update Consent Dialog" an.

  6. Lesen Sie den Softwarelizenzvertrag, und klicken Sie dann auf "Annehmen".

    Die Anwendung "Zustimmungsdialog aktualisieren" wird angezeigt und zeigt den folgenden Text an: Die Anwendung, die Sie installieren möchten, sucht nach den neuesten Updates im Web. Durch Klicken auf "Ich stimme zu" autorisieren Sie die Anwendung, automatisch im Internet nach Updates zu suchen.

  7. Klicken Sie auf "Zustimmen", und klicken Sie dann auf "Weiter".

    Die Anwendung beginnt mit der Installation.

  8. Wenn das Dialogfeld "Anwendungsinstallation" angezeigt wird, klicken Sie auf "Installieren".

Verwandte Inhalte

  • Last updated on