<entryPoint>-Element (ClickOnce-Anwendung)

Artikel
06/10/2015

Identifiziert die Assembly, die ausgeführt werden muss, wenn die ClickOnce-Anwendung auf einem Clientcomputer ausgeführt wird.

<entryPoint 
   name 
> 
   <assemblyIdentity 
      name 
      version 
      processorArchitecture 
      language 
   /> 
   <commandLine 
      file 
      parameters 
   /> 
   <customHostRequired /> 
   <customUX /> 
</entryPoint>

Elemente und Attribute

Das entryPoint-Element ist erforderlich und befindet sich im urn:schemas-microsoft-com:asm.v2-Namespace. Es gibt möglicherweise nur ein in einem Anwendungsmanifest definiertes entryPoint-Element.

Das entryPoint-Element verfügt über das folgende Attribut.

Attribut	Beschreibung
name	Optional. Dieser Wert wird nicht von .NET Framework verwendet.

entryPoint weist folgende Elemente auf.

assemblyIdentity

Erforderlich. Die Rolle von assemblyIdentity und die zugehörigen Attribute werden unter <assemblyIdentity>-Element (ClickOnce-Anwendung) definiert.

Das processorArchitecture-Attribut dieses Elements und das processorArchitecture-Attribut, das in assemblyIdentity an einer anderen Stelle im Anwendungsmanifest definiert ist, müssen sich entsprechen.

commandLine

Erforderlich. Muss ein untergeordnetes Element des entryPoint-Elements sein. Es weist keine untergeordneten Elemente auf und verfügt über die folgenden Attribute.

Attribut	Beschreibung
file	Erforderlich. Ein lokaler Verweis auf die Startassembly für die ClickOnce-Anwendung. Dieser Wert kann nicht die folgenden Pfadtrennzeichen enthalten: Schrägstrich (/) oder umgekehrter Schrägstrich (\).
parameters	Erforderlich. Beschreibt die Aktion, die bei dem Einstiegspunkt ausgeführt werden soll. Der einzige gültige Wert lautet run. Wenn eine leere Zeichenfolge angegeben wird, wird der Wert run angenommen.

customHostRequired

Optional. Wenn vorhanden gibt es an, dass die Bereitstellung keine eigenständige Anwendung ist, sondern eine Komponente enthält, die innerhalb eines benutzerdefinierten Hosts bereitgestellt wird.

Wenn dieses Element vorhanden ist, dürfen die Elemente assemblyIdentity und commandLine nicht ebenfalls vorhanden sein. Wenn sie vorhanden sind, löst ClickOnce während der Installation einen Validierungsfehler aus.

Dieses Element verfügt über keine Attribute und keine untergeordneten Elemente.

customUX

Optional. Gibt an, dass die Anwendung von einem benutzerdefinierten Installationsprogramm installiert und verwaltet wird, und erstellt keinen Eintrag im Startmenü, eine Verknüpfung oder einen Eintrag in "Software".

<customUX xmlns="urn:schemas-microsoft-com:clickonce.v1" />

Eine Anwendung, die das customUX-Element einschließt, muss ein benutzerdefiniertes Installationsprogramm bereitstellen, das die InPlaceHostingManager-Klasse verwendet, um Installationsvorgänge auszuführen. Eine Anwendung mit diesem Element kann nicht installiert werden, indem man auf das Manifest oder den erforderlichen setup.exe-Bootstrapper doppelklickt. Das benutzerdefinierte Installationsprogramm kann Startmenüeinträge, Verknüpfungen und Einträge aus "Software" erstellen. Wenn das benutzerdefinierte Installationsprogramm keinen Eintrag in "Software" erstellt, muss der von der SubscriptionIdentity-Eigenschaft bereitgestellte Abonnementbezeichner gespeichert werden, und der Benutzer muss die Anwendung später durch Aufrufen der UninstallCustomUXApplication-Methode deinstallieren können. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Installers für eine ClickOnce-Anwendung.

Hinweise

Dieses Element identifiziert die Assembly und den Einstiegspunkt für die ClickOnce-Anwendung.

commandLine kann nicht verwendet werden, um zur Laufzeit Parameter an die Anwendung zu übergeben. Sie können über die AppDomain der Anwendung auf Abfragezeichenfolgen-Parameter für eine ClickOnce-Bereitstellung zugreifen. Weitere Informationen finden Sie unter Gewusst wie: Abrufen von Abfragezeichenfolgen-Informationen in einer Online-ClickOnce-Anwendung.

Beispiel

Im folgenden Codebeispiel wird ein entryPoint-Element in einem Anwendungsmanifest für eine ClickOnce-Anwendung veranschaulicht. Dieses Codebeispiel ist Teil eines umfangreichen Beispiels, das für das Thema ClickOnce-Anwendungsmanifest bereitgestellt wird.

<!-- Identify the main code entrypoint. -->
<!-- This code runs the main method in an executable assembly. -->
  <entryPoint>
    <assemblyIdentity 
      name="MyApplication" 
      version="1.0.0.0"
      language="neutral"
      processorArchitecture="x86" />
    <commandLine file="MyApplication.exe" parameters="" />
  </entryPoint>

Siehe auch

Referenz

ClickOnce-Anwendungsmanifest

Share via