<entryPoint>-Element (ClickOnce-Anwendung)

  • Artikel

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

Syntax

<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. In einem Anwendungsmanifest darf nur ein entryPoint-Element definiert sein.

Das entryPoint -Element hat das folgende Attribut.

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

entryPoint hat die folgenden Elemente:

assemblyIdentity

Erforderlich. Die Rolle von assemblyIdentity und die zugehörigen Attribute werden im <assemblyIdentity>-Element definiert.

Das processorArchitecture-Attribut dieses Elements und das processorArchitecture-Attribut, das in der assemblyIdentity an anderer Stelle im Anwendungsmanifest definiert ist, müssen übereinstimmen.

commandLine

Erforderlich. Muss ein untergeordnetes Element des entryPoint-Elements sein. Es enthält keine untergeordneten Elemente und weist die folgenden Attribute auf.

Attribut BESCHREIBUNG
file Erforderlich. Ein lokaler Verweis auf die Startassembly für die ClickOnce-Anwendung. Dieser Wert darf keine Schrägstriche (/) oder umgekehrte Schrägstriche (\) als Pfadtrennzeichen enthalten.
parameters Erforderlich. Beschreibt die Aktion, die mit dem Einstiegspunkt ausgeführt werden soll. Der einzige gültige Wert ist run. Wenn eine leere Zeichenfolge angegeben wird, wird run angenommen.

customHostRequired

Optional. Falls enthalten, gibt dieser Wert an, dass diese Bereitstellung eine Komponente enthält, die in einem benutzerdefinierten Host bereitgestellt wird und keine eigenständige Anwendung ist.

Wenn dieses Element vorhanden ist, dürfen die assemblyIdentity- und commandLine-Elemente nicht ebenfalls vorhanden sein. Andernfalls löst ClickOnce während der Installation einen Überprüfungsfehler aus.

Dieses Element besitzt keine Attribute und keine untergeordneten Elemente.

customUX

Optional. Gibt an, dass die Anwendung von einem benutzerdefinierten Installationsprogramm installiert und verwaltet wird. Es wird kein Startmenüeintrag, keine Verknüpfung und kein Eintrag „Software“ erstellt.

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

Eine Anwendung, die das customUX-Element enthält, muss ein benutzerdefiniertes Installationsprogramm bereitstellen, das die InPlaceHostingManager-Klasse zum Ausführen von Installationsvorgängen verwendet. Eine Anwendung mit diesem Element kann nicht durch Doppelklicken auf ihr Manifest oder die Datei „setup.exe“ des erforderlichen Bootstrappers installiert werden. Das benutzerdefinierte Installationsprogramm kann Startmenüeinträge, Verknüpfungen und Einträge zum Hinzufügen oder Entfernen von Programmen erstellen. Wenn das benutzerdefinierte Installationsprogramm keinen Eintrag „Software“ erstellt, muss es den Abonnementbezeichner speichern, der von der SubscriptionIdentity-Eigenschaft bereitgestellt wird, und es dem Benutzer ermöglichen, die Anwendung später durch Aufrufen der UninstallCustomUXApplication-Methode zu deinstallieren. Weitere Informationen finden Sie unter Exemplarische Vorgehensweise: Erstellen eines benutzerdefinierten Installationsprogramms für eine ClickOnce-Anwendung.

Hinweise

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

Sie können nicht commandLineverwenden, um Parameter zur Laufzeit an Ihre Anwendung zu übergeben. Sie können über AppDomain der Anwendung auf Abfragezeichenfolgenparameter für eine ClickOnce-Bereitstellung zugreifen. Weitere Informationen finden Sie unter Vorgehensweise: Abrufen von Abfragezeichenfolgeninformationen in einer ClickOnce-Onlineanwendung.

Beispiel

Das folgende Codebeispiel zeigt das entryPoint-Element in einem Anwendungsmanifest für eine ClickOnce-Bereitstellung. Dieses Codebeispiel ist Teil eines umfangreicheren 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>

Weitere Informationen