Freigeben über

Verwenden des Bootstrapperbeispiels für "Setup.exe" mit einer Anwendung

Die mit dem Bootstrapperbeispiel für Setup.exe durchgeführten Operationen finden automatisch statt. Wenn Sie jedoch Setup.exe die Verwendung der Anwendung ermöglichen möchten, müssen Sie eine benutzerdefinierte Datei Settings.ini mit den erforderlichen Informationen zur Anwendung erstellen. Weiterhin empfiehlt es sich, das Setupprogramm mit einer Readme-Datei weiterzugeben, in der den Benutzern die Mindestkonfigurationsanforderungen für die Installation von Anwendung und Dotnetfx.exe erläutert werden. Die folgenden Themen enthalten ausführliche Informationen über das Erstellen der Datei Settings.ini und der Readme-Datei.

Erstellen einer Settings.ini-Datei

Erstellen einer "Readme"-Datei für das Setupprogramm

Erstellen einer Settings.ini-Datei

Im Bootstrapperbeispiel für Setup.exe wird mit Hilfe der externen Datei Settings.ini Folgendes bestimmt:

  • Der Speicherort für Dotnetfx.exe und die Hostanwendung
  • Die zu suchende Sprachversion von .NET Framework
  • Die für Setup.exe-Dialogfelder zu verwendenden benutzerdefinierten Zeichenfolgen

Der Standardspeicherort von Settings.ini ist der Ordner, in der auch Setup.exe gespeichert ist. Erstellen Sie eine Datei Settings.ini, die es dem Bootstrapperbeispiel für Setup.exe ermöglicht, zusammen mit der Anwendung ausgeführt zu werden. Sie können die im Bootstrapperbeispiel für Setup.exe enthaltene Datei Settings.ini kopieren und nach Bedarf bearbeiten, um die richtigen Werte für die Anwendung anzugeben.

Angeben des Speicherortes für "Dotnetfx.exe" und die Hostanwendung

Beim Bootstrapperbeispiel für Setup.exe ist es erforderlich, dass sich Dotnetfx.exe und die .NET Framework-Hostanwendung in Relation zu Setup.exe an einem bekannten Ort befinden. Das Bootstrapperbeispiel für Setup.exe verwendet die externe Datei Settings.ini, um den Speicherort von Dotnetfx.exe und der Hostanwendung zu bestimmen. Sie können die im Beispiel enthaltene Datei Settings.ini kopieren und so bearbeiten, dass sie auf den Speicherort der .NET Framework-Hostanwendung und auf Dotnetfx.exe zeigt.

Die folgenden Beispiele von Settings.ini-Dateien veranschaulichen, wie auf ein Windows Installer-Paket (MSI-Datei) für eine .NET Framework-Hostanwendung und für Dotnetfx.exe gezeigt wird, das sich relativ zu Setup.exe an verschiedenen Speicherorten befindet.

Die folgende Settings.ini-Beispieldatei zeigt auf das Windows Installer-Paket für die .NET Framework-Anwendung mySetup.msi und Dotnetfx.exe, die in demselben Ordner gespeichert sind wie Setup.exe. Nicht anzupassende Zeilen sind mit einem Hochkomma " ' " auskommentiert.

[Bootstrap]
Msi=mySetup.msi
'LanguageDirectory=
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Die folgende Settings.ini-Beispieldatei zeigt auf das Windows Installer-Paket für die .NET Framework-Anwendung mySetup.msi und Dotnetfx.exe, die in einer Freigabe im Netzwerk und somit von Setup.exe getrennt gespeichert sind.

[Bootstrap]
Msi=\\myNetworkShare\myProjectFolder\mySetup.msi
'LanguageDirectory=
ProductName=My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=\\myNetworkShare\myProjectFolder\

Die folgende Settings.ini-Beispieldatei zeigt auf das Windows Installer-Paket für die .NET Framework-Anwendung mySetup.msi und Dotnetfx.exe, die auf demselben Computer gespeichert sind wie Setup.exe, sich jedoch in einem unterschiedlichen Ordner befinden.

[Bootstrap]
Msi=c:\myInstallerFiles\mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myExecutables\

Die folgende Settings.ini-Beispieldatei zeigt auf das Windows Installer-Paket für die .NET Framework-Anwendung mySetup.msi und Dotnetfx.exe, die auf derselben CD gespeichert sind wie Setup.exe, sich jedoch in einem unterschiedlichen Ordner befinden.

[Bootstrap]
Msi=myInstallerFiles/mySetup.msi
'LanguageDirectory=
ProductName= My Application
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=myExecutables/

Angeben der Sprachversion

Wenn Setup.exe eine Buildnummer und eine Sprachversion von .NET Framework ermitteln soll, müssen Sie den Kulturnamen der zu suchenden Sprache in der Datei Settings.ini angeben. Wenn Sie keinen Kulturnamen angeben, sucht Setup.exe standardmäßig nach der englischen Sprachversion.

Die folgende Tabelle enthält eine Auflistung der verfügbaren Sprachversionen sowie die jeweiligen in der Datei Settings.ini anzugebenden Kulturnamen. Bei Kulturnamen wird die Groß- und Kleinschreibung berücksichtigt.

Sprache Kulturname
Chinesisch (vereinfacht) chs
Chinesisch (traditionell) cht
Deutsch de
Französisch fr
Italienisch it
Japanisch ja
Koreanisch ko
Spanisch es

Die folgende Settings.ini-Beispieldatei weist Setup.exe an, die französische Sprachversion von Dotnetfx.exe zu suchen.

[Bootstrap]
Msi=mySetup.msi
LanguageDirectory=fr
ProductName= My Application 
'DialogText=
CaptionText=My Application
ErrorCaptionText= My Application Error
FxInstallerPath=c:\myProjectFolder\

Anpassen von Zeichenfolgen für "Setup.exe"-Dialogfelder

Sie können die folgenden Variablen in der Datei Settings.ini bearbeiten, um die in Setup.exe-Dialogfeldern angezeigten Zeichenfolgen anzupassen.

  • ProductName
    Gibt den Namen der .NET Framework-Anwendung an, die von Setup.exe installiert wird. Der angegebene Produktname wird zum Anpassen von Text in den Dialogfeldern verwendet, die nach dem Starten von Setup.exe angezeigt werden. Wenn Sie beispielsweise My Application als ProductName angeben, wird der folgende Text im Dialogfeld angezeigt: "Zum Starten von Setup für My Application klicken Sie auf OK Um Setup zu beenden, ohne die Anwendung zu installieren, klicken Sie auf Abbrechen."

    Wenn Sie die CaptionText-Variable nicht anpassen, wird ProductName ebenfalls zum Anpassen der Titelleiste für das Dialogfeld verwendet, das nach dem Starten von Setup.exe angezeigt wird. Wenn Sie beispielsweise My Application als ProductName angeben, wird auf der Titelleiste "My Application-Setup" angezeigt. Wenn Sie sowohl ProductName als auch CaptionText angeben, wird CaptionText zum Anpassen des Titelleistentextes in diesem Dialogfeld verwendet.

    ProductName wird auch verwendet, um den Titelleistentext im Bestätigungsdialogfeld anzupassen, das nach Abschluss der Installation angezeigt wird. Wenn Sie ProductName nicht anpassen, wird der Standardtext "Anwendungs-Setup" angezeigt.

  • DialogText
    Gibt den im Dialogfeld anzuzeigenden benutzerdefinierten Text an, der nach dem Starten von Setup.exe angezeigt wird. Wenn Sie DialogText nicht anpassen, wird der Standardtext "Zum Starten von Setup für eine Anwendung klicken Sie auf OK. Um Setup zu beenden, ohne die Anwendung zu installieren, klicken Sie auf Abbrechen."

  • CaptionText
    Gibt den benutzerdefinierten Text für die Titelleiste des Dialogfelds an, der nach dem Starten von Setup.exe angezeigt wird. Wenn Sie CaptionText nicht anpassen, wird ProductName angezeigt. Wenn Sie ProductName nicht anpassen, wird der Standardtext "Anwendungs-Setup" angezeigt.

  • ErrorCaptionText
    Gibt den in der Titelleiste der Setup.exe-Fehlerdialogfelder anzuzeigenden benutzerdefinierten Text an. Wenn Sie ErrorCaptionText nicht anpassen, wird der Standardtext "Fehler beim Setup für eine Anwendung" angezeigt.

Erstellen einer "Readme"-Datei für das Setupprogramm

Es empfiehlt sich, das Setupprogramm mit einer Readme-Datei weiterzugeben, in der die Mindestkonfigurationsanforderungen für einen Computer angegeben sind, auf dem das Setupprogramm ausgeführt werden soll. Führen Sie mindestens Microsoft Windows 98 oder höher und Internet Explorer 5.01 oder höher als Anforderung für die Installation auf. Weiterhin sollte MDAC 2.6 oder höher mit der Angabe aufgelistet werden, dass dieses Programm nicht zu den Installationsvoraussetzungen zählt, jedoch für .NET Framework-Anwendungen erforderlich ist, die Datenzugriff verwenden. Weitere Informationen zu den Mindestkonfigurationsanforderungen für die Installation von Dotnetfx.exe finden Sie unter Mindestkonfigurationsanforderungen.

Siehe auch

Weitergeben von .NET Framework | Erstellen eines Setup-Projekts für die gleichzeitige Installation einer .NET Framework-Anwendung und von "Dotnetfx.exe" | Operationen des Bootstrapperbeispiels für "Setup.exe" | Mindestkonfigurationsanforderungen

  • Last updated on